syntaxmatrix 2.6.4.2__py3-none-any.whl → 2.6.4.4__py3-none-any.whl

syntaxmatrix/core.py

@@ -34,6 +34,10 @@ from syntaxmatrix.settings.prompts import(
 )
 from syntaxmatrix.settings.client_items import read_client_file, getenv_api_key
 
+from .premium import FeatureGate
+from .plugin_manager import PluginManager
+
+
 # ──────── framework‐local storage paths ────────
 # this ensures the key & data always live under the package dir,
 _CLIENT_DIR = detect_project_root()
@@ -127,6 +131,18 @@ class SyntaxMUI:
         self.is_streaming = False
         self.stream_args = {}
         self._apply_feature_flags_from_db()
+        # Premium (entitlements + plugins). Safe no-op unless configured.
+        try:
+            self.feature_gate = FeatureGate(client_dir=_CLIENT_DIR, db=db)
+        except Exception:
+            self.feature_gate = FeatureGate(client_dir=_CLIENT_DIR)
+
+        try:
+            self.plugins = PluginManager(self, gate=self.feature_gate, db=db)
+            self.plugins.load_all()
+        except Exception:
+            # Never break app boot because of premium plumbing
+            self.plugins = PluginManager(self)
 
         self._recent_visual_summaries = []
 
@@ -345,8 +361,8 @@ class SyntaxMUI:
             return str(v or "").strip().lower() in ("1", "true", "yes", "on")
 
         try:
-            stream_v = db.get_setting("feature.stream_mode", "0")
-            user_files_v = db.get_setting("feature.user_files", "0")
+            stream_v = db.get_setting("feature.stream_mode", "1")
+            user_files_v = db.get_setting("feature.user_files", "1")
 
             self.is_streaming = _truthy(stream_v)
             self.user_files_enabled = _truthy(user_files_v)
@@ -887,7 +903,12 @@ class SyntaxMUI:
         if not self.chat_profile:
             chat_profile = _prof.get_profile("chat") or _prof.get_profile("admin")
             if not chat_profile:
-                yield """<p style='color:red;'>Error: Chat profile is not configured. Add a chat profile inside the admin panel or contact your administrator.</p>
+                yield """
+                <p style='color:red;'>
+                    Error!<br> 
+                    Chat profile is not configured. Add a chat profile inside the admin panel.
+                    To do that, you must login first or contact your administrator.
+                </p>
                 """
                 return None
             self.chat_profile = chat_profile
@@ -967,14 +988,20 @@ class SyntaxMUI:
         except Exception as e:
             yield f"Error during streaming: {type(e).__name__}: {e}"
     
+
     def process_query(self, query, context, history, stream=False):
 
         if not self.chat_profile:
             chat_profile = _prof.get_profile("chat") or _prof.get_profile("admin")
             if not chat_profile:
-                return """<p style='color:red;'>Error: Chat profile is not configured. Add a chat profile inside the admin panel or contact your administrator.</p>
+                yield """
+                <p style='color:red;'>
+                    Error!<br> 
+                    Chat profile is not configured. Add a chat profile inside the admin panel.
+                    To do that, you must login first or contact your administrator.
+                </p>
                 """
-                return
+            return None
                  
             self.chat_profile = chat_profile
             self.chat_profile['client'] = _prof.get_client(chat_profile) 

syntaxmatrix/db.py

@@ -6,6 +6,8 @@ from werkzeug.utils import secure_filename
 from syntaxmatrix.project_root import detect_project_root
 
 
+_SMX_DB_PROVIDER = (os.environ.get("SMX_DB_PROVIDER") or "sqlite").strip().lower()
+
 _CLIENT_DIR = detect_project_root()
 DB_PATH = os.path.join(_CLIENT_DIR, "data", "syntaxmatrix.db")
 os.makedirs(os.path.dirname(DB_PATH), exist_ok=True)
@@ -624,3 +626,78 @@ def get_setting(key: str, default: str | None = None) -> str | None:
         return row[0] if row else default
     finally:
         conn.close()
+
+
+# ============================================================================
+# Optional DB backend override (Premium hook)
+#
+# Default behaviour (no env vars): SQLite stays in use exactly as before.
+#
+# To enable a premium backend (e.g. Postgres), set:
+#   SMX_DB_PROVIDER=postgres
+#
+# Optional:
+#   SMX_DB_BACKEND_MODULE=syntaxmatrix_premium.db_backends.postgres_backend
+#
+# The backend module should either expose:
+#   - install(target_globals: dict) -> None     (preferred)
+# OR export a compatible surface (functions/constants) that will be copied
+# into this module namespace.
+# ============================================================================
+
+def _smx_apply_optional_backend_override() -> None:
+    import os
+    import importlib
+
+    provider = (os.getenv("SMX_DB_PROVIDER") or "sqlite").strip().lower()
+    if provider in ("", "sqlite", "sqlite3"):
+        return
+
+    # Pick backend module (allow override for custom installations)
+    mod_name = (os.getenv("SMX_DB_BACKEND_MODULE") or "").strip()
+    if not mod_name:
+        if provider in ("postgres", "postgresql", "pg"):
+            mod_name = "syntaxmatrix.db_backends.postgres_backend"
+        else:
+            # Convention: syntaxmatrix.db_backends.<provider>_backend
+            mod_name = f"syntaxmatrix.db_backends.{provider}_backend"
+
+    try:
+        mod = importlib.import_module(mod_name)
+    except Exception as e:
+        raise RuntimeError(
+            f"SMX_DB_PROVIDER='{provider}' requested, but backend module '{mod_name}' "
+            f"could not be imported. Install the premium backend package (or set "
+            f"SMX_DB_BACKEND_MODULE) and try again. Underlying error: {e}"
+        ) from e
+
+    installer = getattr(mod, "install", None)
+    if callable(installer):
+        installer(globals())
+    else:
+        names = getattr(mod, "__all__", None)
+        if not names:
+            names = [n for n in dir(mod) if not n.startswith("_")]
+        for n in names:
+            globals()[n] = getattr(mod, n)
+
+    # Helpful introspection
+    globals()["_SMX_DB_PROVIDER"] = provider
+    globals()["_SMX_DB_BACKEND_MODULE"] = mod_name
+
+
+# Apply on import
+_smx_apply_optional_backend_override()
+
+# If a non-SQLite backend was requested, validate the required API surface now.
+try:
+    import os as _os
+    _provider = (globals().get("_SMX_DB_PROVIDER") or _os.getenv("SMX_DB_PROVIDER") or "sqlite").strip().lower()
+
+    if _provider not in ("", "sqlite", "sqlite3"):
+        from .db_contract import assert_backend_implements_core_api as _assert_backend_implements_core_api
+        _assert_backend_implements_core_api(globals(), provider=_provider)
+except Exception:
+    # Fail fast with a clear error; this is intentional for premium backends.
+    raise
+

syntaxmatrix/db_backends/__init__.py

@@ -0,0 +1 @@
+# DB backends package

syntaxmatrix/db_backends/postgres_backend.py

@@ -0,0 +1,14 @@
+# syntaxmatrix/db_backends/postgres_backend.py
+"""
+PostgreSQL backend 
+"""
+
+def install(ns: dict) -> None:
+    raise RuntimeError(
+        "Postgres backend is not available in the free tier.\n\n"
+        "You set SMX_DB_PROVIDER=postgres, but the premium Postgres backend package "
+        "is not installed.\n\n"
+        "Fix:\n"
+        "- Install the SyntaxMatrix premium Postgres backend package, then restart.\n"
+        "- Or set SMX_DB_PROVIDER=sqlite to use the built-in SQLite backend.\n"
+    )

syntaxmatrix/db_backends/sqlite_backend.py

@@ -0,0 +1,258 @@
+from __future__ import annotations
+import sqlite3
+import os
+import json
+from werkzeug.utils import secure_filename
+from syntaxmatrix.project_root import detect_project_root
+
+
+_CLIENT_DIR = detect_project_root()
+DB_PATH = os.path.join(_CLIENT_DIR, "data", "syntaxmatrix.db")
+os.makedirs(os.path.dirname(DB_PATH), exist_ok=True)
+
+TEMPLATES_DIR = os.path.join(_CLIENT_DIR, "templates")
+os.makedirs(TEMPLATES_DIR, exist_ok=True)
+
+
+# ------------ Utils ------------
+def connect_db():
+    conn = sqlite3.connect(DB_PATH)
+    conn.row_factory = sqlite3.Row
+    return conn
+
+def _col_exists(conn, table: str, col: str) -> bool:
+    cur = conn.execute(f"PRAGMA table_info({table})")
+    cols = [r["name"] for r in cur.fetchall()]
+    return col in cols
+
+def _ensure_column(conn, table: str, col: str, col_sql: str):
+    if not _col_exists(conn, table, col):
+        conn.execute(f"ALTER TABLE {table} ADD COLUMN {col} {col_sql}")
+
+def _ensure_index(conn, idx_sql: str):
+    try:
+        conn.execute(idx_sql)
+    except Exception:
+        pass
+
+
+# ------------ Schema init ------------
+def init_db():
+    conn = connect_db()
+    conn.execute("""
+        CREATE TABLE IF NOT EXISTS pages (
+            name TEXT PRIMARY KEY,
+            content TEXT NOT NULL,
+            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+            updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+        )
+    """)
+    conn.execute("""
+        CREATE TABLE IF NOT EXISTS page_layouts (
+            name TEXT PRIMARY KEY,
+            layout_json TEXT NOT NULL,
+            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+            updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+        )
+    """)
+    conn.execute("""
+        CREATE TABLE IF NOT EXISTS settings (
+            key TEXT PRIMARY KEY,
+            value TEXT NOT NULL,
+            updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+        )
+    """)
+    conn.execute("""
+        CREATE TABLE IF NOT EXISTS audit_log (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            action TEXT NOT NULL,
+            subject TEXT,
+            meta TEXT,
+            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+        )
+    """)
+
+    _init_media_assets_table(conn)
+
+    conn.commit()
+    conn.close()
+
+
+# ------------ Pages ------------
+def get_pages():
+    conn = connect_db()
+    cur = conn.execute("SELECT name FROM pages ORDER BY name")
+    rows = [r["name"] for r in cur.fetchall()]
+    conn.close()
+    return rows
+
+def get_page(name: str):
+    conn = connect_db()
+    cur = conn.execute("SELECT name, content FROM pages WHERE name = ?", (name,))
+    row = cur.fetchone()
+    conn.close()
+    return dict(row) if row else None
+
+def add_page(name: str, content: str):
+    conn = connect_db()
+    conn.execute("INSERT OR REPLACE INTO pages (name, content) VALUES (?, ?)", (name, content))
+    conn.commit()
+    conn.close()
+
+def update_page(name: str, content: str):
+    conn = connect_db()
+    conn.execute("UPDATE pages SET content = ?, updated_at = CURRENT_TIMESTAMP WHERE name = ?", (content, name))
+    conn.commit()
+    conn.close()
+
+def delete_page(name: str):
+    conn = connect_db()
+    conn.execute("DELETE FROM pages WHERE name = ?", (name,))
+    conn.execute("DELETE FROM page_layouts WHERE name = ?", (name,))
+    conn.commit()
+    conn.close()
+
+def rename_page(old_name: str, new_name: str):
+    conn = connect_db()
+    conn.execute("UPDATE pages SET name = ? WHERE name = ?", (new_name, old_name))
+    conn.execute("UPDATE page_layouts SET name = ? WHERE name = ?", (new_name, old_name))
+    conn.commit()
+    conn.close()
+
+
+# ------------ Layouts ------------
+def upsert_page_layout(name: str, layout_json: str):
+    conn = connect_db()
+    conn.execute(
+        "INSERT OR REPLACE INTO page_layouts (name, layout_json) VALUES (?, ?)",
+        (name, layout_json)
+    )
+    conn.commit()
+    conn.close()
+
+def get_page_layout(name: str):
+    conn = connect_db()
+    cur = conn.execute("SELECT name, layout_json FROM page_layouts WHERE name = ?", (name,))
+    row = cur.fetchone()
+    conn.close()
+    return dict(row) if row else None
+
+def get_all_page_layouts():
+    conn = connect_db()
+    cur = conn.execute("SELECT name, layout_json FROM page_layouts ORDER BY name")
+    rows = [dict(r) for r in cur.fetchall()]
+    conn.close()
+    return rows
+
+
+# ------------ Settings ------------
+def get_setting(key: str, default=None):
+    conn = connect_db()
+    cur = conn.execute("SELECT value FROM settings WHERE key = ?", (key,))
+    row = cur.fetchone()
+    conn.close()
+    if not row:
+        return default
+    try:
+        return json.loads(row["value"])
+    except Exception:
+        return row["value"]
+
+def set_setting(key: str, value):
+    conn = connect_db()
+    conn.execute(
+        "INSERT OR REPLACE INTO settings (key, value, updated_at) VALUES (?, ?, CURRENT_TIMESTAMP)",
+        (key, json.dumps(value))
+    )
+    conn.commit()
+    conn.close()
+
+def delete_setting(key: str):
+    conn = connect_db()
+    conn.execute("DELETE FROM settings WHERE key = ?", (key,))
+    conn.commit()
+    conn.close()
+
+
+# ------------ Audit log ------------
+def audit(action: str, subject: str = "", meta: dict | None = None):
+    conn = connect_db()
+    conn.execute(
+        "INSERT INTO audit_log (action, subject, meta) VALUES (?, ?, ?)",
+        (action, subject, json.dumps(meta or {}))
+    )
+    conn.commit()
+    conn.close()
+
+
+# ------------ Media assets (dedupe + metadata) ------------
+MEDIA_DIR = os.path.join(_CLIENT_DIR, "uploads", "media")
+os.makedirs(MEDIA_DIR, exist_ok=True)
+
+MEDIA_IMAGES_DIR = os.path.join(MEDIA_DIR, "images")
+os.makedirs(MEDIA_IMAGES_DIR, exist_ok=True)
+
+MEDIA_THUMBS_DIR = os.path.join(MEDIA_DIR, "thumbs")
+os.makedirs(MEDIA_THUMBS_DIR, exist_ok=True)
+
+def _init_media_assets_table(conn):
+    conn.execute("""
+        CREATE TABLE IF NOT EXISTS media_assets (
+            id         INTEGER PRIMARY KEY AUTOINCREMENT,
+            kind       TEXT NOT NULL DEFAULT 'image',
+            rel_path   TEXT NOT NULL UNIQUE,
+            thumb_path TEXT,
+            sha256     TEXT,
+            dhash      TEXT,
+            width      INTEGER,
+            height     INTEGER,
+            bytes      INTEGER,
+            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+        )
+    """)
+    _ensure_index(conn, "CREATE INDEX IF NOT EXISTS idx_media_assets_kind ON media_assets(kind)")
+    _ensure_index(conn, "CREATE INDEX IF NOT EXISTS idx_media_assets_sha256 ON media_assets(sha256)")
+    _ensure_index(conn, "CREATE INDEX IF NOT EXISTS idx_media_assets_dhash ON media_assets(dhash)")
+
+def upsert_media_asset(kind: str, rel_path: str, thumb_path: str | None = None,
+                       sha256: str | None = None, dhash: str | None = None,
+                       width: int | None = None, height: int | None = None, bytes_: int | None = None):
+    conn = connect_db()
+    _init_media_assets_table(conn)
+    conn.execute(
+        """
+        INSERT INTO media_assets (kind, rel_path, thumb_path, sha256, dhash, width, height, bytes)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+        ON CONFLICT(rel_path) DO UPDATE SET
+            kind=excluded.kind,
+            thumb_path=excluded.thumb_path,
+            sha256=excluded.sha256,
+            dhash=excluded.dhash,
+            width=excluded.width,
+            height=excluded.height,
+            bytes=excluded.bytes
+        """,
+        (kind, rel_path, thumb_path, sha256, dhash, width, height, bytes_)
+    )
+    conn.commit()
+    conn.close()
+
+def get_media_asset_by_rel_path(rel_path: str):
+    conn = connect_db()
+    cur = conn.execute("SELECT * FROM media_assets WHERE rel_path = ?", (rel_path,))
+    row = cur.fetchone()
+    conn.close()
+    return dict(row) if row else None
+
+def list_media_assets(kind: str = "image"):
+    conn = connect_db()
+    cur = conn.execute("SELECT * FROM media_assets WHERE kind = ? ORDER BY id DESC", (kind,))
+    rows = [dict(r) for r in cur.fetchall()]
+    conn.close()
+    return rows
+
+def normalise_media_filename(filename: str) -> str:
+    filename = secure_filename(filename or "file")
+    if not filename:
+        filename = "file"
+    return filename

syntaxmatrix/db_contract.py

@@ -0,0 +1,71 @@
+# syntaxmatrix/db_contract.py
+from __future__ import annotations
+
+from typing import Dict, Iterable, Optional
+
+
+# Keep this list tight: only functions that the framework truly depends on.
+# If we add more later, we do it deliberately.
+CORE_REQUIRED_FUNCTIONS = (
+    # Pages
+    "get_pages",
+    "get_page_html",
+    "add_page",
+    "update_page",
+    "delete_page",
+
+    # Secrets
+    "get_secrets",
+    "set_secret",
+    "delete_secret",
+
+    # Nav
+    "get_nav_links",
+    "set_nav_links",
+
+    # Page layouts (builder)
+    "get_page_layout",
+    "upsert_page_layout",
+    "delete_page_layout",
+
+    # Media library
+    "add_media_file",
+    "list_media_files",
+    "delete_media_file",
+
+    # Generic settings (used by branding + profiles + other admin toggles)
+    "get_setting",
+    "set_setting",
+
+    # Optional: some backends may want init, but we do not force it here.
+)
+
+
+def assert_backend_implements_core_api(ns: Dict[str, object], *, provider: str = "") -> None:
+    """
+    Validate that the loaded backend provides the minimum required surface.
+
+    `ns` is usually `globals()` from syntaxmatrix.db (the facade module).
+
+    We keep this strict for non-SQLite providers, because:
+    - SQLite is the built-in reference backend.
+    - Premium/Cloud backends must be complete, or we fail fast with a clear error.
+    """
+    missing = []
+    for fn in CORE_REQUIRED_FUNCTIONS:
+        obj = ns.get(fn)
+        if not callable(obj):
+            missing.append(fn)
+
+    if missing:
+        prov = provider or "unknown"
+        raise RuntimeError(
+            "SyntaxMatrix DB backend validation failed.\n"
+            f"Provider: {prov}\n"
+            "Missing required functions:\n"
+            f"  - " + "\n  - ".join(missing) + "\n\n"
+            "Fix:\n"
+            "- If you are using the premium Postgres backend, ensure the premium package is installed\n"
+            "  and that your backend module's install(ns) correctly injects these functions.\n"
+            "- If you are writing your own backend, implement the missing functions.\n"
+        )

syntaxmatrix/plugin_manager.py

@@ -0,0 +1,114 @@
+from __future__ import annotations
+
+import importlib
+import json
+import os
+from dataclasses import dataclass
+from typing import Any, Dict, List, Optional, Tuple
+
+
+def _safe_json_loads(raw: str, *, default: Any) -> Any:
+    try:
+        return json.loads(raw)
+    except Exception:
+        return default
+
+
+@dataclass
+class PluginSpec:
+    """A single plugin to load.
+
+    module: python module path (e.g. 'syntaxmatrix_premium_cloud_db')
+    name: entitlement key (e.g. 'cloud_db')
+    """
+
+    name: str
+    module: str
+
+
+class PluginManager:
+    """Loads optional plugins (typically premium) in a controlled, safe way."""
+
+    ENV_PLUGINS = "SMX_PREMIUM_PLUGINS"          # JSON list of {name,module}
+    DB_PLUGINS_KEY = "premium.plugins"          # JSON list of {name,module}
+
+    def __init__(self, smx: object, *, gate: Optional[object] = None, db: Optional[object] = None):
+        self._smx = smx
+        self._gate = gate
+        self._db = db
+        self.loaded: Dict[str, str] = {}   # name -> module
+        self.errors: List[str] = []
+
+    def _specs_from_env(self) -> List[PluginSpec]:
+        raw = os.environ.get(self.ENV_PLUGINS, "").strip()
+        if not raw:
+            return []
+        data = _safe_json_loads(raw, default=[])
+        return self._coerce_specs(data)
+
+    def _specs_from_db(self) -> List[PluginSpec]:
+        if not self._db:
+            return []
+        get_setting = getattr(self._db, "get_setting", None)
+        if not callable(get_setting):
+            return []
+        raw = get_setting(self.DB_PLUGINS_KEY, "[]")
+        data = _safe_json_loads(str(raw or "[]"), default=[])
+        return self._coerce_specs(data)
+
+    def _coerce_specs(self, data: Any) -> List[PluginSpec]:
+        out: List[PluginSpec] = []
+        if isinstance(data, list):
+            for row in data:
+                if not isinstance(row, dict):
+                    continue
+                name = str(row.get("name") or "").strip()
+                module = str(row.get("module") or "").strip()
+                if name and module:
+                    out.append(PluginSpec(name=name, module=module))
+        return out
+
+    def _entitled(self, name: str) -> bool:
+        if not self._gate:
+            return True  # if no gate configured, don't block
+        enabled = getattr(self._gate, "enabled", None)
+        if not callable(enabled):
+            return True
+        try:
+            return bool(enabled(name))
+        except Exception:
+            return False
+
+    def load_all(self) -> Tuple[Dict[str, str], List[str]]:
+        """Load all configured plugins. Returns (loaded, errors)."""
+        specs = self._specs_from_env()
+        if not specs:
+            specs = self._specs_from_db()
+
+        for spec in specs:
+            if not self._entitled(spec.name):
+                continue
+            if spec.name in self.loaded:
+                continue
+            self._load_one(spec)
+
+        return self.loaded, self.errors
+
+    def _load_one(self, spec: PluginSpec) -> None:
+        try:
+            mod = importlib.import_module(spec.module)
+        except Exception as e:
+            self.errors.append(f"{spec.name}: import failed: {e}")
+            return
+
+        # Plugin contract: module exposes register(smx) -> None
+        reg = getattr(mod, "register", None)
+        if not callable(reg):
+            self.errors.append(f"{spec.name}: missing register(smx) function")
+            return
+
+        try:
+            reg(self._smx)
+            self.loaded[spec.name] = spec.module
+        except Exception as e:
+            self.errors.append(f"{spec.name}: register() failed: {e}")

syntaxmatrix/premium/__init__.py

@@ -0,0 +1,10 @@
+"""Premium support.
+
+This package contains runtime plumbing for premium features (entitlements +
+plugin loading). The actual premium implementations should live in separate,
+private distributions.
+"""
+
+from .gate import FeatureGate
+
+__all__ = ["FeatureGate"]

syntaxmatrix/premium/gate.py

@@ -0,0 +1,107 @@
+from __future__ import annotations
+
+import json
+import os
+from dataclasses import dataclass
+from typing import Any, Dict, Optional
+
+
+def _safe_json_loads(raw: str, *, default: Any) -> Any:
+    try:
+        return json.loads(raw)
+    except Exception:
+        return default
+
+
+@dataclass
+class GateSources:
+    """Where the gate reads entitlements from.
+
+    Precedence (highest first):
+      1) env_json
+      2) db_setting_key
+      3) licence_file
+    """
+
+    env_json: str = "SMX_PREMIUM_ENTITLEMENTS"
+    db_setting_key: str = "premium.entitlements"
+    licence_file_relpath: str = os.path.join("premium", "licence.json")
+
+
+class FeatureGate:
+    """Runtime entitlement checks for premium features.
+
+    This is intentionally small, dependency-free, and safe:
+    - If anything fails, it returns 'not entitled' rather than crashing the app.
+    """
+
+    def __init__(
+        self,
+        *,
+        client_dir: str,
+        db: Optional[object] = None,
+        sources: Optional[GateSources] = None,
+    ):
+        self._client_dir = client_dir
+        self._db = db
+        self._sources = sources or GateSources()
+        self._cache: Optional[Dict[str, Any]] = None
+
+    def _load_from_env(self) -> Optional[Dict[str, Any]]:
+        raw = os.environ.get(self._sources.env_json)
+        if not raw:
+            return None
+        data = _safe_json_loads(raw, default=None)
+        return data if isinstance(data, dict) else None
+
+    def _load_from_db(self) -> Optional[Dict[str, Any]]:
+        if not self._db:
+            return None
+        get_setting = getattr(self._db, "get_setting", None)
+        if not callable(get_setting):
+            return None
+
+        raw = get_setting(self._sources.db_setting_key, "{}")
+        data = _safe_json_loads(str(raw or "{}"), default={})
+        return data if isinstance(data, dict) else None
+
+    def _load_from_file(self) -> Optional[Dict[str, Any]]:
+        p = os.path.join(self._client_dir, self._sources.licence_file_relpath)
+        if not os.path.exists(p):
+            return None
+        try:
+            with open(p, "r", encoding="utf-8") as f:
+                data = json.load(f)
+            return data if isinstance(data, dict) else None
+        except Exception:
+            return None
+
+    def entitlements(self, *, refresh: bool = False) -> Dict[str, Any]:
+        """Returns entitlement dict (possibly empty)."""
+        if self._cache is not None and not refresh:
+            return self._cache
+
+        ent = self._load_from_env()
+        if ent is None:
+            ent = self._load_from_db()
+        if ent is None:
+            ent = self._load_from_file()
+        if ent is None:
+            ent = {}
+
+        self._cache = ent
+        return ent
+
+    def enabled(self, key: str) -> bool:
+        """True if entitlement exists and is truthy."""
+        key = (key or "").strip()
+        if not key:
+            return False
+        ent = self.entitlements()
+        return bool(ent.get(key))
+
+    def get(self, key: str, default: Any = None) -> Any:
+        key = (key or "").strip()
+        if not key:
+            return default
+        return self.entitlements().get(key, default)

syntaxmatrix/routes.py

@@ -5715,8 +5715,8 @@ def setup_routes(smx):
             flash("Settings updated ✓")
             return redirect(url_for("admin_features"))
 
-        stream_mode = _truthy(db.get_setting("feature.stream_mode", "0"))
-        user_files = _truthy(db.get_setting("feature.user_files", "0"))
+        stream_mode = _truthy(db.get_setting("feature.stream_mode", "1"))
+        user_files = _truthy(db.get_setting("feature.user_files", "1"))
 
         return render_template(
             "admin_features.html",
@@ -7964,7 +7964,6 @@ def setup_routes(smx):
       nav = _generate_nav()
       footer = footer_html()
 
-      # now use render_template_string so we can drop the same head/nav/footer
       return render_template_string(f"""
         {head}
         <body>
@@ -7982,17 +7981,17 @@ def setup_routes(smx):
             <pre style="background:#f4f4f4;padding:1rem;
                         border-radius:4px;text-align:left;
                         overflow-x:auto;max-height:200px;">
-  {{{{ error_message }}}}
+              {{ error_message }}
             </pre>
             <p>
-              <a href="{{{{ url_for('home') }}}}"
+              <a href="{{ url_for('home') }}"
                 style="display:inline-block;
-                        margin-top:2rem;
-                        padding:0.75rem 1.25rem;
-                        background:#007acc;
-                        color:#fff;
-                        text-decoration:none;
-                        border-radius:4px;">
+                  margin-top:2rem;
+                  padding:0.75rem 1.25rem;
+                  background:#007acc;
+                  color:#fff;
+                  text-decoration:none;
+                  border-radius:4px;">
                 ← Back to Home
               </a>
             </p>

syntaxmatrix/settings/model_map.py

@@ -5,23 +5,23 @@ import os
 PROVIDERS_MODELS = {
     #1
     "OpenAI": [ 
-        "gpt-5.2",                      # $1.75	$0.175	$14.00
-        "gpt-5.2-chat-latest",          # $1.75	$0.175	$14.00
-        "gpt-5.2-pro",                  # $21.00	-	$168.00
-        "gpt-5.1",                      # $1.25	$0.125	$10.00
-        "gpt-5.1-chat-latest",          # $1.25	$0.125	$10.00
+        "gpt-5.2",                      
+        "gpt-5.2-chat-latest",         
+        "gpt-5.2-pro",                  
+        "gpt-5.1",                      
+        "gpt-5.1-chat-latest",          
         "gpt-5.1-codex-mini",           
-        "gpt-5.1-codex-max",            # $1.25	$0.125	$10.00
-        "gpt-5",                        # $1.25	$0.125	$10.00
-        "gpt-5-nano",                   # $0.05	$0.005	$0.40
-        "gpt-5-mini",                   # $0.25	$0.025	$2.00
-        "gpt-5-pro",                    # $15.00	-	$120.00
-        "gpt-4.1",                      # $2.00	$0.50	$8.00
-        "gpt-4.1-nano",                 # $0.10	$0.025	$0.40
-        "gpt-4.1-mini",                 # $0.40	$0.10	$1.60
-        "gpt-4o",                       # $2.50	$1.25	$10.00
-        # "gpt-4o-mini",                  # $0.15	$0.075	$0.60
-        # "gpt-4o-mini-search-preview",   # $0.15	   -	$0.60 
+        "gpt-5.1-codex-max",            
+        "gpt-5",                        
+        "gpt-5-nano",                  
+        "gpt-5-mini",                   
+        "gpt-5-pro",                   
+        "gpt-4.1",                      
+        "gpt-4.1-nano",                 
+        "gpt-4.1-mini",                
+        "gpt-4o",                       
+        "gpt-4o-mini",                  
+        # "gpt-4o-mini-search-preview",  
     ],
     #2
     "Google": [    
@@ -175,7 +175,7 @@ MODEL_DESCRIPTIONS = {
     #         - Summarizer
     #     """,
     
-    #1.4 OpenAI
+    #1.3 OpenAI
     "gpt-4.1":"""
         Model: GPT 4.1
             Cost: 
@@ -199,7 +199,7 @@ MODEL_DESCRIPTIONS = {
             - Coder
     """,
 
-    #1.5 OpenAI
+    #1.4 OpenAI
     "gpt-4.1-nano":"""
         Model: GPT 4.1 Nano
             Cost: 
@@ -226,7 +226,7 @@ MODEL_DESCRIPTIONS = {
             - ImageTexter
     """,
 
-    #1.6 OpenAI
+    #1.5 OpenAI
     "gpt-4.1-mini":"""
         Model: GPT 4.1 Mini
             Cost: 
@@ -254,7 +254,7 @@ MODEL_DESCRIPTIONS = {
             - ImageTexter
     """,
 
-    #1.7 OpenAI
+    #1.6 OpenAI
     "gpt-5":"""
         Model: GPT 5
             Cost: 
@@ -279,7 +279,7 @@ MODEL_DESCRIPTIONS = {
             - Coder
     """,
 
-    #1.8 OpenAI 
+    #1.7 OpenAI 
     "gpt-5-nano":"""
         Model: GPT 5 Nano
             Cost: 
@@ -307,7 +307,7 @@ MODEL_DESCRIPTIONS = {
             - ImageTexter
     """,
     
-    #1.9 OpenAI 
+    #1.8 OpenAI 
     "gpt-5-mini":"""
         Model: GPT 5 Mini
             Cost: 
@@ -342,7 +342,7 @@ MODEL_DESCRIPTIONS = {
    
       #1.8 OpenAI 
     
-    #1.10 OpenAI 
+    #1.9 OpenAI 
     "gpt-5-pro":"""
         Model: GPT 5 Pro
             Cost: 
@@ -367,7 +367,7 @@ MODEL_DESCRIPTIONS = {
             - Coder
     """,
 
-    #1.11 OpenAI 
+    #1.10 OpenAI 
     "gpt-5.1":"""
         Model: GPT 5.1
             Cost: 
@@ -393,7 +393,7 @@ MODEL_DESCRIPTIONS = {
             - Coder
     """,
 
-    #1.12 OpenAI 
+    #1.11 OpenAI 
     "gpt-5.1-chat-latest":"""
         Model: GPT 5.1 Chat
             Cost: 
@@ -419,7 +419,7 @@ MODEL_DESCRIPTIONS = {
             - Chat
     """,
 
-    #1.13 OpenAI 
+    #1.12 OpenAI 
     "gpt-5.1-codex-mini":"""
         Model: GPT 5.1 Codex Mini
             Cost: 
@@ -444,7 +444,7 @@ MODEL_DESCRIPTIONS = {
             - Coder
     """,
 
-    #1.14 OpenAI 
+    #1.13 OpenAI 
     "gpt-5.1-codex-max":"""
         Model: GPT 5.1 Codex Max
             Cost: 
@@ -469,7 +469,7 @@ MODEL_DESCRIPTIONS = {
             - Coder
     """,
 
-    #1.15 OpenAI 
+    #1.14 OpenAI 
     "gpt-5.2":"""
         Model: GPT 5.2
             Cost: 
@@ -494,7 +494,7 @@ MODEL_DESCRIPTIONS = {
             - Coder
     """,
     
-    #1.16 OpenAI
+    #1.15 OpenAI
     "gpt-5.2-chat-latest":"""
         Model: GPT 5.2 Chat
             Cost: 
@@ -519,7 +519,7 @@ MODEL_DESCRIPTIONS = {
             - Admin
     """,   
 
-    #1.17 OpenAI 
+    #1.16 OpenAI 
     "gpt-5.2-pro":"""
         Model: GPT 5.2 Pro
             Cost: 

{syntaxmatrix-2.6.4.2.dist-info → syntaxmatrix-2.6.4.4.dist-info}/METADATA

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: syntaxmatrix
-Version: 2.6.4.2
+Version: 2.6.4.4
 Summary: SyntaxMUI: A customizable framework for Python AI Assistant Projects.
 Author: Bob Nti
 Author-email: bob.nti@syntaxmatrix.net
+License: MIT
 Classifier: Programming Language :: Python :: 3.9
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -48,6 +48,7 @@ Dynamic: author-email
 Dynamic: classifier
 Dynamic: description
 Dynamic: description-content-type
+Dynamic: license
 Dynamic: license-file
 Dynamic: requires-dist
 Dynamic: requires-python

{syntaxmatrix-2.6.4.2.dist-info → syntaxmatrix-2.6.4.4.dist-info}/RECORD

@@ -2,9 +2,10 @@ syntaxmatrix/__init__.py,sha256=_LnTrYAW2tbYA37Y233Vv4OMOk8NUnoJi-1yzFyHxEI,2573
 syntaxmatrix/auth.py,sha256=SCD6uWojXjj9yjUTKzgV5kBYe6ZkXASEG2VopLFkEtM,18140
 syntaxmatrix/bootstrap.py,sha256=Y7ZNg-Z3ecrr1iYem5EMzPmGstXnEKmO9kqKVoOoljo,817
 syntaxmatrix/commentary.py,sha256=3c8qBAKJI2IcYd9PBZrFEwmv-c4_tfa3ebEoPa5vW7U,12428
-syntaxmatrix/core.py,sha256=q1TbQx0gf_jBGDkQKdFGPEByuER0PEZnFqwaWSbOmco,66592
+syntaxmatrix/core.py,sha256=IKcvPJMbTMwv0eqkeLx4se3AU_Qx7LNNbS5sz-VWVf4,67485
 syntaxmatrix/dataset_preprocessing.py,sha256=wtV4MWzkyfOsBHTsS0H1gqHho77ZQHGDI9skJryyZWA,8732
-syntaxmatrix/db.py,sha256=MLpNs-Ue3xjEwaOJOMgFuPEz_gP9Fr3b1__BA3A3RDg,20801
+syntaxmatrix/db.py,sha256=Q3b_Dr8LifWpGQyBsA-MLc8pBQjFJbc0ox0t_sbdECE,23722
+syntaxmatrix/db_contract.py,sha256=N7WvdTgRH87XX7K5cPSDXvNfHNsSZ4xxZO5DL5vrpVA,2141
 syntaxmatrix/display_html.py,sha256=tBeeHcRbmAOKqRTXY0hUehThFspCDsvjW4myi2zj0iU,3568
 syntaxmatrix/emailer.py,sha256=KazaSY0ieE5kC5nTVmh-O2N3gjfeG_oBnl4pl_UHEws,949
 syntaxmatrix/file_processor.py,sha256=9-TT20qfhZ7Q0eWCJpdxDA54jWM9g56A6VJNFme2azY,2863
@@ -18,10 +19,11 @@ syntaxmatrix/page_builder_generation.py,sha256=EuRVsHLxYDo0SQUo9apMY0ML0-OnaZ9kD
 syntaxmatrix/page_layout_contract.py,sha256=4i18ireN2wigWD3mGIA5A6RMw-0DCxnEXpKuu3UrHog,25175
 syntaxmatrix/page_patch_publish.py,sha256=pakIo8tA2y_2zulrU7aBqbqXkmgJLc2-YwghDvYKbgs,50473
 syntaxmatrix/plottings.py,sha256=MjHQ9T1_oC5oyr4_wkM2GJDrpjp0sbvudbs2lGaMyzk,6103
+syntaxmatrix/plugin_manager.py,sha256=sRpm6xGU8AQSDU_bnh1aHHARwl4uqNYgYXgKlFGHYm4,3747
 syntaxmatrix/preface.py,sha256=tCm0C0BhY_SOntQT5I7cOJr6TB5mVDAeL9i8UmHLu5g,21237
 syntaxmatrix/profiles.py,sha256=hPg27IQjl8-Tpo3BanQQsByeAgcizqIA2I_IKKNZ0TI,2900
 syntaxmatrix/project_root.py,sha256=1ckvbFVV1szHtHsfSCoGcImHkRwbfszmPG1kGh9ZZlE,2227
-syntaxmatrix/routes.py,sha256=EwjA9Q3r1dHXkuzF_93DdOY2q3AikQmpxCLC3nATVTc,357004
+syntaxmatrix/routes.py,sha256=CMBWRB7b1ju1odxWT6K7b8njkjz__f8XlX0biKSozKA,356892
 syntaxmatrix/selftest_page_templates.py,sha256=JY1i2xu7FBkN0TIPiAXhEk_iIjdOBmfc1g9aX98iqhw,14833
 syntaxmatrix/session.py,sha256=v0qgxnVM_LEaNvZQJSa-13Q2eiwc3RDnjd2SahNnHQk,599
 syntaxmatrix/smiv.py,sha256=1lSN3UYpXvYoVNd6VrkY5iZuF_nDxD6xxvLnTn9wcbQ,1405
@@ -38,13 +40,18 @@ syntaxmatrix/agentic/agents.py,sha256=IVqF2VLl-80nx75FW0-RK2-2nfhbQjVwyGgplgVOea
 syntaxmatrix/agentic/agents_orchestrer.py,sha256=NMC0Mr1zRxxWBr-KRZxu1iLMBJowqesNIkuNwY1AlQA,14681
 syntaxmatrix/agentic/code_tools_registry.py,sha256=rV0sA1qf_a9A4mmJXGuLnPD6qzAtTBjVgViYpwykfRU,1489
 syntaxmatrix/agentic/model_templates.py,sha256=A3ROE3BHkvnU9cxqSGjlCBIw9U15zRaTKgK-WxcZtUI,76033
+syntaxmatrix/db_backends/__init__.py,sha256=ocEqHP5enZCCpurdITAucrrWbw2peihBC6AM3Ck9AAI,23
+syntaxmatrix/db_backends/postgres_backend.py,sha256=vveUAz8Ss2KSFQRpKVxjBPpgqabw-Z5VVKHHdKxsuSU,519
+syntaxmatrix/db_backends/sqlite_backend.py,sha256=DJ70rB7NCRpcYZ6heGnrunt9lxxFgAaidLcio-8y8U0,8384
 syntaxmatrix/media/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 syntaxmatrix/media/media_pixabay.py,sha256=_gkntpbK7HzyLOtzoyWLjXXWtCXUFknD4hFHn_qHfRY,8195
+syntaxmatrix/premium/__init__.py,sha256=ab4z0PWcMSbnIIqyRBHWTqoE1NyhhW5kzIHNcdhZ4J4,269
+syntaxmatrix/premium/gate.py,sha256=-ko1x4iNZZxe6DYTZdW9Cni38NAbfdZoGJ5Co_813l0,3273
 syntaxmatrix/settings/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 syntaxmatrix/settings/client_items.py,sha256=jtJ2k5r_Roq42Pumor_VEsYVTIdbFVP2l61MOeMAPUc,868
 syntaxmatrix/settings/default.yaml,sha256=BznvF1D06VMPbT6UX3MQ4zUkXxTXLnAA53aUu8G4O38,569
 syntaxmatrix/settings/logging.py,sha256=U8iTDFv0H1ECdIzH9He2CtOVlK1x5KHCk126Zn5Vi7M,1362
-syntaxmatrix/settings/model_map.py,sha256=Sh84M4ZeKCSYNwgTS9u00-bWjD_8tMW_WVBEEyV8yLY,26712
+syntaxmatrix/settings/model_map.py,sha256=P3RsBGkq36ozADjZOY_p8bjvLgaleiZynMgl4HP1qR8,26385
 syntaxmatrix/settings/prompts.py,sha256=Gni--SPxFfqbQXPJqkK0tdViBtAMtUBp185i5WdYux4,25888
 syntaxmatrix/settings/string_navbar.py,sha256=NqgTzo3J9rRI4c278VG6kpoViFfmi2FKmL6sO0R-bus,83
 syntaxmatrix/static/docs.md,sha256=rWlKjNcpS2cs5DElGNYuaA-XXdGZnRGMXx62nACvDwE,11105
@@ -78,8 +85,8 @@ syntaxmatrix/vectordb/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5
 syntaxmatrix/vectordb/adapters/milvus_adapter.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 syntaxmatrix/vectordb/adapters/pgvector_adapter.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 syntaxmatrix/vectordb/adapters/sqlite_adapter.py,sha256=L8M2qHfwZRAFVxWeurUVdHaJXz6F5xTUSWh3uy6TSUs,6035
-syntaxmatrix-2.6.4.2.dist-info/licenses/LICENSE.txt,sha256=j1P8naTdy1JMxTC80XYQjbyAQnuOlpDusCUhncrvpy8,1083
-syntaxmatrix-2.6.4.2.dist-info/METADATA,sha256=Lfr4JXJYE44Ezkm909Yfp6RYLT7GziLSNk70_qSBcg8,18221
-syntaxmatrix-2.6.4.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-syntaxmatrix-2.6.4.2.dist-info/top_level.txt,sha256=HKP_zkl4V_nt7osC15DlacoBZktHrbZYOqf_pPkF3T8,13
-syntaxmatrix-2.6.4.2.dist-info/RECORD,,
+syntaxmatrix-2.6.4.4.dist-info/licenses/LICENSE.txt,sha256=j1P8naTdy1JMxTC80XYQjbyAQnuOlpDusCUhncrvpy8,1083
+syntaxmatrix-2.6.4.4.dist-info/METADATA,sha256=UZK3_MnFpYk0wb3AUfEJx100W6v4ra2oHM_9Wt54DyE,18201
+syntaxmatrix-2.6.4.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+syntaxmatrix-2.6.4.4.dist-info/top_level.txt,sha256=HKP_zkl4V_nt7osC15DlacoBZktHrbZYOqf_pPkF3T8,13
+syntaxmatrix-2.6.4.4.dist-info/RECORD,,