ApiLogicServer 15.0.0__py3-none-any.whl → 15.0.10__py3-none-any.whl

api_logic_server_cli/prototypes/base/integration/mcp/test_notes.txt

@@ -1,37 +0,0 @@
-LLM request - new...?
-
-[
-    {
-        "role": "system",
-        "content": "You are an API planner that converts natural language queries into MCP Tool Context blocks using JSON:API. Return only the tool context as JSON."
-    },
-    {
-        "role": "user",
-        "content": "Schema:\n{\"base_url\": \"http://localhost:5656/api\", \"description\": \"API Logic Project: basic_demo\", \"email_services\": \"iff email is requested, Send email by issing a POST request to the Email endpoint, setting the subject, message and customer_id in the body.\", \"expected_response\": \"Respond with a JSON object with schema_version and a resource array including: tool_type, base_url, path, method, query_params array or body, headers.\", \"query_params\": \"- JSON:API custom filtering using a filter array (e.g., filter=[{\\\"name\\\":\\\"date_shipped\\\",\\\"op\\\":\\\"gt\\\",\\\"val\\\":\\\"2023-07-14\\\"}])\", \"resources\": [{\"fields\": [\"id\", \"name\", \"balance\", \"credit_limit\"], \"filterable\": [\"id\", \"name\", \"balance\", \"credit_limit\"], \"methods\": [\"GET\", \"PATCH\", \"POST\", \"DELETE\"], \"name\": \"Customer\", \"path\": \"/Customer\"}, {\"fields\": [\"id\", \"order_id\", \"product_id\", \"quantity\", \"amount\", \"unit_price\"], \"filterable\": [\"id\", \"order_id\", \"product_id\", \"quantity\", \"amount\", \"unit_price\"], \"methods\": [\"GET\", \"PATCH\", \"POST\", \"DELETE\"], \"name\": \"Item\", \"path\": \"/Item\"}, {\"fields\": [\"id\", \"notes\", \"customer_id\", \"date_shipped\", \"amount_total\"], \"filterable\": [\"id\", \"notes\", \"customer_id\", \"date_shipped\", \"amount_total\"], \"methods\": [\"GET\", \"PATCH\", \"POST\", \"DELETE\"], \"name\": \"Order\", \"path\": \"/Order\"}, {\"fields\": [\"id\", \"name\", \"unit_price\"], \"filterable\": [\"id\", \"name\", \"unit_price\"], \"methods\": [\"GET\", \"PATCH\", \"POST\", \"DELETE\"], \"name\": \"Product\", \"path\": \"/Product\"}, {\"fields\": [\"id\", \"request\", \"request_prompt\", \"completion\"], \"filterable\": [\"id\", \"request\", \"request_prompt\", \"completion\"], \"methods\": [\"GET\", \"PATCH\", \"POST\", \"DELETE\"], \"name\": \"Mcp\", \"path\": \"/Mcp\"}], \"schema_version\": \"1.0\", \"tool_type\": \"json-api\"}\n\nNatural language query: 'List the unshipped orders created before 2023-07-14, and send a discount email (subject: 'Discount Offer') to the customer for each one.'"
-    }
-]
-
-LLM request - old
- [
-    {
-        "role": "system",
-        "content": "You are an API planner that converts natural language queries into MCP Tool Context blocks using JSON:API. Return only the tool context as JSON."
-    },
-    {
-        "role": "user",
-        "content": "Schema:\n{\"base_url\": \"http://localhost:5656/api\", \"description\": \"API Logic Project: basic_demo\", \"email_services\": \"iff email is requested, Send email by issing a POST request to the Email endpoint, setting the subject, message and customer_id in the body.\", \"expected_response\": \"Respond with a JSON object with schema_version and a resource array including: tool_type, base_url, path, method, query_params array or body, headers.\", \"query_params\": \"- JSON:API custom filtering using a filter array (e.g., filter=[{\\\"name\\\":\\\"date_shipped\\\",\\\"op\\\":\\\"gt\\\",\\\"val\\\":\\\"2023-07-14\\\"}])\", \"resources\": [{\"fields\": [\"id\", \"name\", \"balance\", \"credit_limit\"], \"filterable\": [\"id\", \"name\", \"balance\", \"credit_limit\"], \"methods\": [\"GET\", \"PATCH\", \"POST\", \"DELETE\"], \"name\": \"Customer\", \"path\": \"/Customer\"}, {\"fields\": [\"id\", \"order_id\", \"product_id\", \"quantity\", \"amount\", \"unit_price\"], \"filterable\": [\"id\", \"order_id\", \"product_id\", \"quantity\", \"amount\", \"unit_price\"], \"methods\": [\"GET\", \"PATCH\", \"POST\", \"DELETE\"], \"name\": \"Item\", \"path\": \"/Item\"}, {\"fields\": [\"id\", \"notes\", \"customer_id\", \"date_shipped\", \"amount_total\"], \"filterable\": [\"id\", \"notes\", \"customer_id\", \"date_shipped\", \"amount_total\"], \"methods\": [\"GET\", \"PATCH\", \"POST\", \"DELETE\"], \"name\": \"Order\", \"path\": \"/Order\"}, {\"fields\": [\"id\", \"name\", \"unit_price\"], \"filterable\": [\"id\", \"name\", \"unit_price\"], \"methods\": [\"GET\", \"PATCH\", \"POST\", \"DELETE\"], \"name\": \"Product\", \"path\": \"/Product\"}, {\"fields\": [\"id\", \"request\", \"request_prompt\", \"completion\"], \"filterable\": [\"id\", \"request\", \"request_prompt\", \"completion\"], \"methods\": [\"GET\", \"PATCH\", \"POST\", \"DELETE\"], \"name\": \"Mcp\", \"path\": \"/Mcp\"}], \"schema_version\": \"1.0\", \"tool_type\": \"json-api\"}\n\nNatural language query: 'List the unshipped orders created before 2023-07-14, and send a discount email (subject: 'Discount Offer') to the customer for each one.'"
-    }
-]
-
-
-messages - new
-[{'role': 'system', 'content': 'You are an API planner that converts natural language queries into MCP Tool Context b...API. Return only the tool context as JSON.'}, {'role': 'user', 'content': 'Schema:\n{"base_url": "http://localhost:5656/api", "description": "API Logic Project: ...) to the customer for each one.'"}]
-
-messages- old
-[{'role': 'system', 'content': 'You are an API planner that converts natural language queries into MCP Tool Context blocks using JSON:API. Return only the tool context as JSON.'}, {'role': 'user', 'content': 'Schema:\n{"base_url": "http://localhost:5656/api", "description": "API Logic Project: basic_demo", "email_services": "iff email is requested, Send email by issing a POST request to the Email endpoint, setting the subject, message and customer_id in the body.", "expected_response": "Respond with a JSON object with schema_version and a resource array including: tool_type, base_url, path, method, query_params array or body, headers.", "query_params": "- JSON:API custom filtering using a filter array (e.g., filter=[{\\"name\\":\\"date_shipped\\",\\"op\\":\\"gt\\",\\"val\\":\\"2023-07-14\\"}])", "resources": [{"fields": ["id", "name", "balance", "credit_limit"], "filterable": ["id", "name", "balance", "credit_limit"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Customer", "path": "/Customer"}, {"fields": ["id", "order_id", "product_id", "quantity", "amount", "unit_price"], "filterable": ["id", "order_id", "product_id", "quantity", "amount", "unit_price"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Item", "path": "/Item"}, {"fields": ["id", "notes", "customer_id", "date_shipped", "amount_total"], "filterable": ["id", "notes", "customer_id", "date_shipped", "amount_total"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Order", "path": "/Order"}, {"fields": ["id", "name", "unit_price"], "filterable": ["id", "name", "unit_price"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Product", "path": "/Product"}, {"fields": ["id", "request", "request_prompt", "completion"], "filterable": ["id", "request", "request_prompt", "completion"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Mcp", "path": "/Mcp"}], "schema_version": "1.0", "tool_type": "json-api"}\n\nNatural language query: \'List the unshipped orders created before 2023-07-14, and send a discount email (subject: \'Discount Offer\') to the customer for each one.\''}]
-
-old content
-'Schema:\n{"base_url": "http://localhost:5656/api", "description": "API Logic Project: basic_demo", "email_services": "iff email is requested, Send email by issing a POST request to the Email endpoint, setting the subject, message and customer_id in the body.", "expected_response": "Respond with a JSON object with schema_version and a resource array including: tool_type, base_url, path, method, query_params array or body, headers.", "query_params": "- JSON:API custom filtering using a filter array (e.g., filter=[{\\"name\\":\\"date_shipped\\",\\"op\\":\\"gt\\",\\"val\\":\\"2023-07-14\\"}])", "resources": [{"fields": ["id", "name", "balance", "credit_limit"], "filterable": ["id", "name", "balance", "credit_limit"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Customer", "path": "/Customer"}, {"fields": ["id", "order_id", "product_id", "quantity", "amount", "unit_price"], "filterable": ["id", "order_id", "product_id", "quantity", "amount", "unit_price"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Item", "path": "/Item"}, {"fields": ["id", "notes", "customer_id", "date_shipped", "amount_total"], "filterable": ["id", "notes", "customer_id", "date_shipped", "amount_total"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Order", "path": "/Order"}, {"fields": ["id", "name", "unit_price"], "filterable": ["id", "name", "unit_price"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Product", "path": "/Product"}, {"fields": ["id", "request", "request_prompt", "completion"], "filterable": ["id", "request", "request_prompt", "completion"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Mcp", "path": "/Mcp"}], "schema_version": "1.0", "tool_type": "json-api"}\n\nNatural language query: \'List the unshipped orders created before 2023-07-14, and send a discount email (subject: \'Discount Offer\') to the customer for each one.\''
-
-where new content looks correct:
-'Schema:\n{"base_url": "http://localhost:5656/api", "description": "API Logic Project: basic_demo", "email_services": "iff email is requested, Send email by issing a POST request to the Email endpoint, setting the subject, message and customer_id in the body.", "expected_response": "Respond with a JSON object with schema_version and a resource array including: tool_type, base_url, path, method, query_params array or body, headers.", "query_params": "- JSON:API custom filtering using a filter array (e.g., filter=[{\\"name\\":\\"date_shipped\\",\\"op\\":\\"gt\\",\\"val\\":\\"2023-07-14\\"}])", "resources": [{"fields": ["id", "name", "balance", "credit_limit"], "filterable": ["id", "name", "balance", "credit_limit"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Customer", "path": "/Customer"}, {"fields": ["id", "order_id", "product_id", "quantity", "amount", "unit_price"], "filterable": ["id", "order_id", "product_id", "quantity", "amount", "unit_price"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Item", "path": "/Item"}, {"fields": ["id", "notes", "customer_id", "date_shipped", "amount_total"], "filterable": ["id", "notes", "customer_id", "date_shipped", "amount_total"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Order", "path": "/Order"}, {"fields": ["id", "name", "unit_price"], "filterable": ["id", "name", "unit_price"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Product", "path": "/Product"}, {"fields": ["id", "request", "request_prompt", "completion"], "filterable": ["id", "request", "request_prompt", "completion"], "methods": ["GET", "PATCH", "POST", "DELETE"], "name": "Mcp", "path": "/Mcp"}], "schema_version": "1.0", "tool_type": "json-api"}\n\nNatural language query: \'List the unshipped orders created before 2023-07-14, and send a discount email (subject: \'Discount Offer\') to the customer for each one.\''

api_logic_server_cli/prototypes/basic_demo/customizations/api/api_discovery/mcp_discovery.py

@@ -1,96 +0,0 @@
-from flask import request, jsonify
-from flask import Flask, redirect, send_from_directory, send_file
-import logging
-import os
-import json
-import io
-
-import requests
-from config.config import Args  # circular import error if at top
-
-app_logger = logging.getLogger("api_logic_server_app")
-
-def add_service(app, api, project_dir, swagger_host: str, PORT: str, method_decorators = []):
-    pass
-
-    def get_server_url():
-        """ return the server URL for the OpenAPI spec """
-        result = f'http://{Args.instance.swagger_host}:{Args.instance.swagger_port}'
-        # get env variable API_LOGIC_SERVER_TUNNEL (or None)
-        if tunnel_url := os.getenv("API_LOGIC_SERVER_TUNNEL", None):
-            app_logger.info(f".. tunnel URL: {tunnel_url}")
-            result = tunnel_url
-        return result  #  + '/api'
-        
-
-    @app.before_request
-    def before_any_request():
-        # print(f"[DEBUG] Incoming request: {request.method} {request.url}")
-        if activate_openapi_logging := True:
-            if request.content_type == 'application/json' and request.method in ['POST', 'PUT', 'PATCH']:
-                # openapi: Incoming request: PATCH http://localhost:5656/api/Customer/1/ {'data': {'attributes': {'credit_limit': 5555}, 'type': 'Customer', 'id': '1'}}
-                # openapi: Incoming request: PATCH http://6f6f-2601-644-4900-d6f0-ecc9-6df3-8863-c5b2.ngrok-free.app/api/Customer/1 {'credit_limit': 5555}
-
-                app_logger.info(f"openapi: Incoming request: {request.method} {request.url} {str(request.json)}")
-            else:
-                app_logger.info(f"openapi: Incoming request: {request.method} {request.url}")
-            # app_logger.info(f"openapi: Incoming request headers: {request.headers}")
-
-            chatgpt_request_json = {
-                        "credit_limit": 25000,
-            }
-            standard_request_json = {
-                "data": {
-                    "type": "Customer",
-                    "id": "ALFKI",
-                    "attributes": {
-                        "name": "Alice",
-                        "credit_limit": 25000,
-                        "balance": 12345
-                    }
-                }
-            }
-            swagger_request_json = {
-                'data': {
-                    'attributes': {
-                        'credit_limit': 5555
-                        }, 
-                    'type': 'Customer', 
-                    'id': '1'
-                }
-            }
-        pass
-    
-
-    @app.route('/.well-known/mcp.json', methods=['GET'])
-    def mcp_discovery(path=None):
-        ''' called by mcp_client_executor for discovery, eg:
-        ```
-        {
-            "tool_type": "json-api",
-            "schema_version": "1.0",
-            "base_url": "https://crm.company.com",
-            "resources": [
-                {
-                "name": "Customer",
-                "path": "/Customer",
-                "methods": ["GET", "PATCH"],
-                "fields": ["id", "name", "balance", "credit_limit"],
-                "filterable": ["name", "credit_limit"],
-                "example": "List customers with credit over 5000"
-                }
-            ]
-        }
-        ```
-        test: curl -X GET "http://localhost:5656/.well-known/mcp.json"
-        '''
-        # return docs/mcp_schema.json
-        schema_path = os.path.join(project_dir, "docs/mcp_learning/mcp_schema.json")
-        try:
-            with open(schema_path, "r") as schema_file:
-                schema = json.load(schema_file)
-                return jsonify(schema), 200
-        except Exception as e:
-            app_logger.error(f"Error loading MCP schema: {e}")
-            return jsonify({"error": "MCP schema not found"}), 404
-        pass

api_logic_server_cli/prototypes/basic_demo/customizations/config/server_setup.py

@@ -1,388 +0,0 @@
-#!/usr/bin/env python3
-
-###############################################################################
-#
-#    Initalization functions used by api_logic_server_run.py
-#
-#    You typically do not customize this file,
-#        except to override Creation Defaults and Logging, below.
-#
-###############################################################################
-
-"""
-Operation:
-    1. api_logic_server_run.py - imports config
-        1. captures args
-    2. api_logic_server_run.py - imports server_setup
-        1. server_setup#logging_setup()
-    3. api_logic_server_run.py - server_setup.api_logic_server_setup
-On error, NOT CALLED: constraint_handler or ValidationErrorExt (!)
-
-+ Operation:
-    1. api_logic_server_run.py - imports config
-        1. captures args
-        1. config#logging_setup()
-    2. api_logic_server_run.py - imports server_setup
-    3. api_logic_server_run.py - server_setup.api_logic_server_setup
-
-"""
-
-start_up_message = "normal start"
-
-import traceback
-try:
-    import os, logging, logging.config, sys, yaml  # failure here means venv probably not set
-except:
-    track = traceback.format_exc()
-    print(" ")
-    print(track)
-    print("venv probably not set")
-    print("Please see https://apilogicserver.github.io/Docs/Project-Env/ \n")
-    exit(1)
-
-from flask_sqlalchemy import SQLAlchemy
-import json
-from pathlib import Path
-if os.getenv("EXPERIMENT") == '+':
-    import config
-from config.config import Args
-
-
-setup_path = Path(os.path.abspath(os.path.dirname(__file__)))
-project_path = setup_path.parent
-
-
-def is_docker() -> bool:
-    """ running docker?  dir exists: /home/api_logic_server """
-    path = '/home/api_logic_server'
-    path_result = os.path.isdir(path)  # this *should* exist only on docker
-    env_result = "DOCKER" == os.getenv('APILOGICSERVER_RUNNING')
-    # assert path_result == env_result
-    return path_result
-
-
-if is_docker():
-    sys.path.append(os.path.abspath('/home/api_logic_server'))
-
-logic_alerts = True
-""" Set False to silence startup message """
-declare_logic_message = ""
-declare_security_message = "ALERT:  *** Security Not Enabled ***"
-
-project_dir = str(project_path)
-os.chdir(project_dir)  # so admin app can find images, code
-import api.system.api_utils as api_utils
-logic_logger_activate_debug = False
-""" True prints all rules on startup """
-
-args = ""
-arg_num = 0
-for each_arg in sys.argv:
-    args += each_arg
-    arg_num += 1
-    if arg_num < len(sys.argv):
-        args += ", "
-project_name = os.path.basename(os.path.normpath(project_path))
-
-from typing import TypedDict
-import safrs  # fails without venv - see https://apilogicserver.github.io/Docs/Project-Env/
-from database.system.SAFRSBaseX import SAFRSBase
-from safrs import ValidationError, SAFRSAPI as _SAFRSAPI
-#from safrs import ValidationError, SAFRSBase, SAFRSAPI as _SAFRSAPI
-from logic_bank.logic_bank import LogicBank
-from logic_bank.exceptions import LBActivateException
-from logic_bank.exec_row_logic.logic_row import LogicRow
-from logic_bank.rule_type.constraint import Constraint
-from .activate_logicbank import activate_logicbank
-from sqlalchemy.ext.declarative import declarative_base
-from sqlalchemy.orm import Session
-import socket
-import warnings
-from flask import Flask, redirect, send_from_directory, send_file
-from flask_cors import CORS
-from safrs import ValidationError, SAFRSAPI
-import ui.admin.admin_loader as AdminLoader
-from security.system.authentication import configure_auth
-import database.bind_dbs as bind_dbs
-import oracledb
-import integration.kafka.kafka_producer as kafka_producer
-import integration.kafka.kafka_consumer as kafka_consumer
-import integration.n8n.n8n_producer as n8n_producer
-
-
-if os.getenv("EXPERIMENT") == '+':
-    app_logger = logging.getLogger("api_logic_server_app")
-
-
-class SAFRSAPI(_SAFRSAPI):
-    """
-    Extends SAFRSAPI to handle client_uri
-
-    Args:
-        _SAFRSAPI (_type_): _description_
-    """
-
-    def __init__(self, *args, **kwargs):
-        client_uri = kwargs.pop('client_uri', None)
-        if client_uri:
-            kwargs['port'] = None
-            kwargs['host'] = client_uri
-        super().__init__(*args, **kwargs)
-
-
-
-# ==================================
-#       Set
-# ================================== 
-
-def get_args(flask_app: Flask) -> Args:
-    """
-    Get Args, update logging
-
-    Returns:
-        Args: typed access to flask_app.config
-    """
-    args = Args(flask_app=flask_app)                                # creation defaults
-
-    import config.config as config
-    flask_app.config.from_object(config.Config)
-    app_logger.debug(f"\nserver_setup - get_args: Config args: \n{args}")  #                 # config file (e.g., db uri's)
-
-    args.get_cli_args(dunder_name=__name__, args=args)
-    app_logger.debug(f"\nserver_setup - get_args: CLI args: \n{args}")                       # api_logic_server_run cl args
-
-    flask_app.config.from_prefixed_env(prefix="APILOGICPROJECT")    # env overrides (e.g., docker)
-    app_logger.debug(f"\nserver_setup - get_args: ENV args: \n{args}\n\n")
-
-    if args.verbose:  # export APILOGICPROJECT_VERBOSE=True
-        app_logger.setLevel(logging.DEBUG)
-        safrs.log.setLevel(logging.DEBUG)  # notset 0, debug 10, info 20, warn 30, error 40, critical 50
-        authentication_logger = logging.getLogger('security.system.authentication')
-        authentication_logger.setLevel(logging.DEBUG)
-        authorization_logger = logging.getLogger('security.system.authorization')
-        authorization_logger.setLevel(logging.DEBUG)
-        auth_provider_logger = logging.getLogger('security.authentication_provider.sql.auth_provider')
-        auth_provider_logger.setLevel(logging.DEBUG)
-        # sqlachemy_logger = logging.getLogger('sqlalchemy.engine')
-        # sqlachemy_logger.setLevel(logging.DEBUG)
-
-    if app_logger.getEffectiveLevel() <= logging.DEBUG:
-        api_utils.sys_info(flask_app.config)
-    app_logger.debug(f"\nserver_setup - get_args: ENV args: \n{args}\n\n")
-    return args
-
-
-# ==================================
-#       LOGGING SETUP
-# ================================== 
-
-def logging_setup() -> logging.Logger:
-    """
-    Setup Logging
-    """
-    global app_logger, debug_value, project_path
-    logging_config = f'{project_path}/config/logging.yml'
-    if os.getenv('APILOGICPROJECT_LOGGING_CONFIG'):
-        logging_config = project_path.joinpath(os.getenv("APILOGICPROJECT_LOGGING_CONFIG"))
-    with open(logging_config,'rt') as f:  # see also logic/declare_logic.py
-            config=yaml.safe_load(f.read())
-            f.close()
-    logging.config.dictConfig(config)  # log levels: notset 0, debug 10, info 20, warn 30, error 40, critical 50
-    app_logger = logging.getLogger("api_logic_server_app")
-    debug_value = os.getenv('APILOGICPROJECT_DEBUG')
-    if debug_value is not None:  # > export APILOGICPROJECT_DEBUG=True
-        debug_value = debug_value.upper()
-        if debug_value.startswith("F") or debug_value.startswith("N"):
-            app_logger.setLevel(logging.INFO)
-        else:
-            app_logger.setLevel(logging.DEBUG)
-            app_logger.debug(f'\nDEBUG level set from env\n')
-    app_logger.info(f'\nAPI Logic Project Server Setup ({project_name}) Starting with CLI args: \n.. {args}\n')
-    app_logger.info(f'Created August 03, 2024 09:34:01 at {str(project_path)}\n') 
-    return app_logger  
-
-
-class ValidationErrorExt(ValidationError):
-    """
-    This exception is raised when invalid input has been detected (client side input)
-    Always send back the message to the client in the response
-    """
-
-    def __init__(self, message="", status_code=400, api_code=2001, detail=None, error_attributes=None):
-        Exception.__init__(self)
-        self.error_attributes = error_attributes
-        self.status_code = status_code
-        self.message = message
-        self.api_code = api_code
-        self.detail: TypedDict = detail
-
-
-def validate_db_uri(flask_app):
-    """
-
-    For sqlite, verify the SQLALCHEMY_DATABASE_URI file exists
-
-        * Since the name is not reported by SQLAlchemy
-
-    Args:
-        flask_app (_type_): initialize flask app
-    """
-
-    db_uri = flask_app.config['SQLALCHEMY_DATABASE_URI']
-    app_logger.debug(f'sqlite_db_path validity check with db_uri: {db_uri}')
-    if 'sqlite' not in db_uri:
-        return
-    sqlite_db_path = ""
-    if db_uri.startswith('sqlite:////'):  # eg, sqlite:////Users/val/dev/ApiLogicServer/ApiLogicServer-dev/servers/ai_customer_orders/database/db.sqlite
-        sqlite_db_path = Path(db_uri[9:])
-        app_logger.debug(f'\t.. Absolute: {str(sqlite_db_path)}')
-    else:                                # eg, sqlite:///../database/db.sqlite
-        db_relative_path = db_uri[10:]
-        db_relative_path = db_relative_path.replace('../', '') # relative
-        sqlite_db_path = Path(os.getcwd()).joinpath(db_relative_path)
-        app_logger.debug(f'\t.. Relative: {str(sqlite_db_path)}')
-        if db_uri == 'sqlite:///database/db.sqlite':
-            raise ValueError(f'This fails, please use; sqlite:///../database/db.sqlite')
-    if sqlite_db_path.is_file():
-        app_logger.debug(f'\t.. sqlite_db_path is a valid file\n')
-    else:  # remove this if you wish
-        raise ValueError(f'sqlite database does not exist: {str(sqlite_db_path)}')
-
-
-
-# ==========================================================
-# API Logic Server Setup
-#   - Opens Database(s)
-#   - Setup API, Logic, Security, Optimistic Locking 
-# ==========================================================
-
-def api_logic_server_setup(flask_app: Flask, args: Args):
-    """
-    API Logic Server Setup
-
-    1. Opens Database(s)
-    2. Setup API, Logic, Security, Optimistic Locking
-
-
-    Args:
-        flask_app (_type_): configured flask_app (servers, ports, db uri's)
-        args (_type_): typed access to flask_app.config
-
-    Raises:
-        ValidationErrorExt: rebadge LogicBank errors for SAFRS API
-    """
-
-    from sqlalchemy import exc as sa_exc
-
-    global logic_logger_activate_debug, declare_logic_message, declare_security_message
-
-    with warnings.catch_warnings():
-
-        safrs_log_level = safrs.log.getEffectiveLevel()
-        db_logger = logging.getLogger('sqlalchemy')
-        db_log_level = db_logger.getEffectiveLevel()
-        safrs_init_logger = logging.getLogger("safrs.safrs_init")
-        authorization_logger = logging.getLogger('security.system.authorization')
-        authorization_log_level = authorization_logger.getEffectiveLevel()
-        do_hide_chatty_logging = True and not args.verbose
-        # eg, system startup health check: read on API and relationship - hide many log entries
-        if do_hide_chatty_logging and app_logger.getEffectiveLevel() <= logging.INFO:
-            safrs.log.setLevel(logging.WARN)  # notset 0, debug 10, info 20, warn 30, error 40, critical 50
-            db_logger.setLevel(logging.WARN)
-            safrs_init_logger.setLevel(logging.WARN)
-            authorization_logger.setLevel(logging.WARN)
-
-        bind_dbs.bind_dbs(flask_app)
-
-        # https://stackoverflow.com/questions/34674029/sqlalchemy-query-raises-unnecessary-warning-about-sqlite-and-decimal-how-to-spe
-        warnings.simplefilter("ignore", category=sa_exc.SAWarning)  # alert - disable for safety msgs
-
-        def constraint_handler(message: str, constraint: Constraint, logic_row: LogicRow):
-            """ format LogicBank constraint exception for SAFRS """
-            if constraint is not None and hasattr(constraint, 'error_attributes'):
-
-                detail = {"model": logic_row.name, "error_attributes": constraint.error_attributes}
-            else:
-                detail = {"model": logic_row.name}
-            raise ValidationErrorExt(message=message, detail=detail)
-
-        admin_enabled = os.name != "nt"
-        admin_enabled = False
-        """ internal use, for future enhancements """
-        if admin_enabled:
-            flask_app.config.update(SQLALCHEMY_BINDS={'admin': 'sqlite:////tmp/4LSBE.sqlite.4'})
-
-        db = SQLAlchemy()
-        db.init_app(flask_app)
-        flask_app.db = db
-        with flask_app.app_context():
-
-            with open(Path(project_path).joinpath('security/system/custom_swagger.json')) as json_file:
-                custom_swagger = json.load(json_file)
-            safrs_api = SAFRSAPI(flask_app, app_db= db, host=args.swagger_host, port=args.swagger_port, client_uri=args.client_uri,
-                                 prefix = args.api_prefix, custom_swagger=custom_swagger)
-
-            if os.getenv('APILOGICSERVER_ORACLE_THICK'):
-                oracledb.init_oracle_client(lib_dir=os.getenv('APILOGICSERVER_ORACLE_THICK'))
-
-            db = safrs.DB  # valid only after is initialized, above
-            session: Session = db.session
-
-            if admin_enabled:  # unused (internal dev use)
-                db.create_all()
-                db.create_all(bind='admin')
-                session.commit()
-
-            from api import expose_api_models, customize_api
-
-            import database.models
-            app_logger.info("Data Model Loaded, customizing...")
-            from database import customize_models
-
-            activate_logicbank(session, constraint_handler)
-            
-            method_decorators : list = []
-            safrs_init_logger.setLevel(logging.WARN)
-            expose_api_models.expose_models(safrs_api, method_decorators)
-            app_logger.info(f'Declare   API - api/expose_api_models, endpoint for each table on {args.swagger_host}:{args.swagger_port}, customizing...')
-            customize_api.expose_services(flask_app, safrs_api, project_dir, swagger_host=args.swagger_host, PORT=args.port)  # custom services
-
-            if args.security_enabled:
-                configure_auth(flask_app, database, method_decorators)
-
-            if args.security_enabled:
-                from security import declare_security  # activate security
-                app_logger.info("..declare security - security/declare_security.py"
-                    # not accurate: + f' -- {len(database.database_discovery.authentication_models.metadata.tables)}'
-                    + ' authentication tables loaded')
-                declare_security_message = declare_security.declare_security_message
-
-            from api.system.opt_locking import opt_locking
-            from config.config import OptLocking
-            if args.opt_locking == OptLocking.IGNORED.value:
-                app_logger.info("\nOptimistic Locking: ignored")
-            else:
-                opt_locking.opt_locking_setup(session)
-
-            kafka_producer.kafka_producer()
-            kafka_consumer.kafka_consumer(safrs_api = safrs_api)
-
-            n8n_producer.n8n_producer()
-
-            SAFRSBase._s_auto_commit = False
-            session.close()
-        
-        safrs.log.setLevel(safrs_log_level)
-        db_logger.setLevel(db_log_level)
-        authorization_logger.setLevel(authorization_log_level)
-
-        if os.getenv('APILOGICPROJECT_DEBUG'):  # temp debug since logging in config is not happening
-            KAFKA_SERVER = os.getenv('KAFKA_SERVER')
-            is_empty = False
-            if KAFKA_SERVER is not None:
-                is_empty = KAFKA_SERVER == ""
-            is_none = KAFKA_SERVER is None
-            app_logger.debug(f'\nDEBUG KAFKA_SERVER: [{KAFKA_SERVER}] (is_empty: {is_empty}) (is_none: {is_none}) \n')
-            app_logger.debug(f'... Args.instance.kafka_producer: {Args.instance.kafka_producer}\n')
-
-

api_logic_server_cli/prototypes/basic_demo/customizations/integration/mcp/README_mcp.md

@@ -1,15 +0,0 @@
-Model Context Protocol is a way for:
-
-1. **Bus User ad hoc flows** using existing published mcp services (vs. hard-coding in IT as an endpoint; flows can be cached for repeated use)
-
-    * ***Natural Language access*** to corporate databases for improved user interfaces
-
-    * LLMs ***choreograph*** multiple MCP calls (to 1 or more MCP servers) in a chain of calls - an agentic workflow. MCPs support shared contexts and goals, enabling the LLM to use the result from 1 call to determine whether the goals has been reached, or which service is appropriate to call next
-
-3. Chat agents to ***discover*** and ***call*** external servers, be they databases, APIs, file systems, etc. MCPs support shared contexts and goals, enabling the LLM
-
-    * ***Corporate database participation*** in such flows, by making key functions available as MCP calls.
-
-This example is [explained here](https://apilogicserver.github.io/Docs/Integration-MCP/).
-
-> Note: this sample uses multi-term filters.  These are usually OR'd together, but this example requires AND.  This is provided by `database/system/SAFRSBaseX.py` (see `return query.filter(operator.and_(*expressions)`) in `_s_filter()`), activated in `config/server_setup.py`.