ApiLogicServer 15.0.12__py3-none-any.whl → 15.0.19__py3-none-any.whl

api_logic_server_cli/prototypes/base/docs/training/admin_app_unused.md

@@ -0,0 +1,156 @@
+
+Generate a full React Admin application using the following instructions.  
+The result must be a runnable React app (`npm start`) that connects to the supplied JSON:API, with fully implemented components (no placeholders or empty files).
+
+## Backend Description
+
+The JSON:API backend is described by:
+
+### 1. Schema (`docs/db.dbml`):
+
+```dbml
+Table Customer {
+    id INTEGER [primary key]
+    name VARCHAR 
+    balance DECIMAL 
+    credit_limit DECIMAL 
+    email VARCHAR 
+    email_opt_out BOOLEAN 
+}
+
+Table Item {
+    id INTEGER [primary key]
+    order_id INTEGER 
+    product_id INTEGER 
+    quantity INTEGER 
+    amount DECIMAL 
+    unit_price DECIMAL 
+}
+
+Table Order {
+    id INTEGER [primary key]
+    notes VARCHAR 
+    customer_id INTEGER 
+    CreatedOn DATE 
+    date_shipped DATE 
+    amount_total DECIMAL 
+}
+
+Table Product {
+    id INTEGER [primary key]
+    name VARCHAR 
+    unit_price DECIMAL 
+}
+
+// Relationships
+Ref: Item.(order_id) < Order.(id)
+Ref: Item.(product_id) < Product.(id)
+Ref: Order.(customer_id) < Customer.(id)
+```
+
+### 2. JSON:API Discovery (`docs/mcp_learning/mcp_discovery.json`):
+
+- Base URL: `http://localhost:5656/api`
+- Auth: `http://localhost:5656/api/auth/login`
+- Tool type: `json-api`
+- Describes four resources: Customer, Order, Item, Product
+
+---
+
+## App Features
+
+### Multi-Page
+
+For each resource:
+- Create a **List page** showing 7 user-friendly columns
+- Add **pagination**, **sorting**, and **filtering**
+- Link each row to a **Display (Show) page**
+
+### Multi-Resource
+
+Each **Display Page** should:
+- Show all fields in a **multi-column layout**
+- Include a **tab sheet** (`<TabbedShowLayout>`) for each related resource using `<ReferenceManyField>`
+- Link child rows to their own display page
+
+Example:  
+- Customer Display has tab for OrderList  
+- Each Order in the tab links to Order Display
+
+### Automatic Joins
+
+For foreign keys:
+- Display joined value (e.g., `product.name` instead of `product_id`)
+- Use first string field from parent table containing `name`, `title`, or `description`
+
+Primary key fields:
+- Display at the end of forms/lists
+
+### Lookups (Foreign Keys)
+
+For foreign key fields:
+- Provide auto-complete dropdown (`<ReferenceInput>`)
+- For numeric foreign keys, use the joined string field as lookup text
+
+---
+
+## Per-Resource Files (Required)
+
+For each resource (`Customer`, `Order`, `Product`, `Item`):
+- Create a source file under `src/`, e.g., `Customer.js`
+- **Each file must fully implement**:
+  - `CustomerList`
+  - `CustomerShow`
+  - `CustomerCreate`
+  - `CustomerEdit`
+
+Use:
+- `<ReferenceField>` for foreign key displays
+- `<ReferenceInput>` for foreign key input
+- `<ReferenceManyField>` for tabbed child lists
+- `<TabbedShowLayout>` for display pages
+
+Do **not leave any file empty**.
+
+---
+
+## App Wiring
+
+In `App.js`:
+- Import each resource file
+- Register them in `<Admin>` using:
+
+```jsx
+<Resource name="Customer" list={CustomerList} show={CustomerShow} edit={CustomerEdit} create={CustomerCreate} />
+```
+
+---
+
+## Architecture
+
+- **Framework**: React 18 + react-admin 4.x
+- **Data Provider**: Custom `dataProvider.js` using `fetchUtils` (no external `ra-jsonapi-client`)
+  - Must support: `getList`, `getOne`, `getMany`, `getManyReference`, `create`, `update`, `delete`
+  - Must support: filters, joins, sorting, pagination
+- **Backend**: JSON:API per `mcp_discovery.json`
+- **CORS**: Ensure API allows `http://localhost:3000`
+  ```py
+  from flask_cors import CORS  
+  CORS(app, origins='*')  # or restrict to localhost:3000
+  ```
+- **Project Setup**:
+  - Use `create-react-app`
+  - Include: `react-admin`, `@mui/material`, `@emotion/react`, `@emotion/styled`, `react-router-dom`
+  - Do not use any deprecated or unmaintained libraries
+  - Include complete and correct `App.js`, `index.js`, `dataProvider.js`, and `index.html`
+
+---
+
+## Run Instructions
+
+```bash
+npm install
+npm start
+```
+
+Then open in browser: `http://localhost:3000`

api_logic_server_cli/prototypes/base/integration/mcp/mcp_client_executor.py

@@ -20,7 +20,7 @@ See: https://apilogicserver.github.io/Docs/Integration-MCP/
 # debug settings
 ################
 
-create_tool_context_from_llm = True
+create_tool_context_from_llm = False
 ''' set to False to bypass LLM call and save 2-3 secs in testing, no API Key required. '''
 
 import os, logging, logging.config, sys
@@ -351,17 +351,18 @@ def process_tool_context(tool_context):
             body = step.get("body", []) 
             # iterate the body fields / values
             # This loop checks each field in the body for a fan-out pattern
-            for attr_name, attr_value in body.items():
-                if isinstance(attr_value, str) and "[*]" in attr_value:
-                    match = re.match(r"\$(\d+)\[\*\]\.(\w+)", attr_value)
-                    if match:
-                        return int(match.group(1)), match.group(2)
-            # If the body is a list, iterate through each field
-            for field in body:
-                if isinstance(field["value"], str) and "[*]" in field["value"]:  # string indices must be integers, not 'str'
-                    match = re.match(r"\$(\d+)\[\*\]\.(\w+)", field["value"])
-                    if match:
-                        return int(match.group(1)), match.group(2)
+            if body is not None:
+                for attr_name, attr_value in body.items():
+                    if isinstance(attr_value, str) and "[*]" in attr_value:
+                        match = re.match(r"\$(\d+)\[\*\]\.(\w+)", attr_value)
+                        if match:
+                            return int(match.group(1)), match.group(2)
+                # If the body is a list, iterate through each field
+                for field in body:
+                    if isinstance(field["value"], str) and "[*]" in field["value"]:  # string indices must be integers, not 'str'
+                        match = re.match(r"\$(\d+)\[\*\]\.(\w+)", field["value"])
+                        if match:
+                            return int(match.group(1)), match.group(2)
         return None
 
 
@@ -468,7 +469,9 @@ def mcp_client_executor(query: str):
     #als: create an MCP request.  See https://apilogicserver.github.io/Docs/Integration-MCP/
 
     Test:
+    * als add-auth --provider-type=None 
     * curl -X 'POST' 'http://localhost:5656/api/SysMcp/' -H 'accept: application/vnd.api+json' -H 'Content-Type: application/json' -d '{ "data": { "attributes": {"request": "List the orders date_shipped is null and CreatedOn before 2023-07-14, and send a discount email (subject: '\''Discount Offer'\'') to the customer for each one."}, "type": "SysMcp"}}'
+
     * Or, use the Admin App and insert a row into SysMCP (see default `query`, below)
 
     Args:

api_logic_server_cli/prototypes/basic_demo/customizations/docs/mcp_learning/mcp_discovery.json

@@ -0,0 +1,108 @@
+{
+  "base_url": "http://localhost:5656/api",
+  "authorization_url": "http://localhost:5656/api/auth/login",
+  "description": "API Logic Project: basic_demo",
+  "learning": "To issue one request per row from a prior step (fan-out), use the syntax:\n\n\"$<stepIndex>[*].<fieldName>\"\n\nFor example, if step 0 returns orders, and you want to send a POST per customer:\n\nBefore (incorrect):\n    \"customer_id\": \"{customer_id}\"\n\nAfter (correct):\n    \"customer_id\": \"$0[*].customer_id\"\n    \nOnly if 'email' is in the Natural language query, send email by issing a POST request to the SysEmail endpoint, setting the subject, message and customer_id in the body.   DO NOT include a POST unless the word \u2018email\u2019 appears in the user query.\n\nFormat response as mcp_responseFormat.\n\n<mcp_responseFormat>\nclass QueryParam(BaseModel):\n    name: str  # attribute name\n    op: str  # eq, lt, gt\n    val: str\n\nclass JsonValues(BaseMopdel):\n    name: str  # name of attribute\n    value: str # value of attribute\n\nclass Resource(BaseModel):\n    tool_type: str\n    base_url: str\n    path: str # specified use case or requirement name (use 'General' if missing)\n    method: str # GET, PATCH, POST or DELETE\n    body: json # data for PATCH or POST\n    query_params: List(QueryParam) # filter for GET\n\nclass MCPResult(BaseModel):  # must match system/genai/prompt_inserts/response_format.prompt\n    schema_version: str\n    resources : List[Resource] # list resources\n\n<mcp_responseFormat/>\n",
+  "resources": [
+    {
+      "fields": [
+        "id",
+        "name",
+        "balance",
+        "credit_limit",
+        "email",
+        "email_opt_out"
+      ],
+      "filterable": [
+        "id",
+        "name",
+        "balance",
+        "credit_limit",
+        "email",
+        "email_opt_out"
+      ],
+      "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",
+        "CreatedOn",
+        "date_shipped",
+        "amount_total"
+      ],
+      "filterable": [
+        "id",
+        "notes",
+        "customer_id",
+        "CreatedOn",
+        "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"
+    }
+  ],
+  "schema_version": "1.0",
+  "tool_type": "json-api"
+}

api_logic_server_cli/prototypes/manager/system/genai/app_templates/app_learning/Admin-App-Learning-Prompt.md

@@ -0,0 +1,154 @@
+## Context
+
+Generate a full React Admin application using the following instructions.  
+The result must be a runnable React app (`npm start`) that connects to the supplied JSON:API, with fully implemented components (no placeholders or empty files).
+
+## App Features
+
+### Multi-Page
+
+For each resource:
+- Create a **List page** showing 7 user-friendly columns
+- Add **pagination**, **sorting**, and **filtering**
+- Link each row to a **Display (Show) page**
+
+### Multi-Resource
+
+Each **Display Page** should:
+- Show all fields in a **multi-column layout**
+- Include a **tab sheet** (`<TabbedShowLayout>`) for each related resource using `<ReferenceManyField>`
+- Link child rows to their own display page
+
+Example:  
+- Customer Display has tab for OrderList 
+  - The tab (with OrderList) is shown *below* all the Customer fields.
+- Each Order in the tab links to Order Display
+
+### Automatic Joins
+
+For foreign keys:
+- Display joined value (e.g., `product.name` instead of `product_id`)
+- Use first string field from parent table containing `name`, `title`, or `description`
+
+Numeric Primary key fields:
+- Display at the end of forms/lists
+
+### Lookups (Foreign Keys)
+
+For foreign key fields:
+- Provide auto-complete dropdown (`<ReferenceInput>`)
+- For numeric foreign keys, use the joined string field as lookup text
+
+### Cascade Add
+
+When adding a child row as a detail in a Master / Detail,
+default the Foreign Key to the Parent (Master) Primary Key.
+
+## Implementation
+
+
+### Architecture
+
+- **Framework**: React 18 + react-admin 4.x
+- **Data Provider**: Custom `dataProvider.js` using `fetchUtils` (no external `ra-jsonapi-client`)
+  - Must support: `getList`, `getOne`, `getMany`, `getManyReference`, `create`, `update`, `delete`
+  - Must support: filters, joins, sorting, pagination
+- **Backend**: JSON:API per `mcp_discovery.json`
+- **CORS**: Ensure API allows `http://localhost:3000`
+  ```py
+  from flask_cors import CORS  
+  CORS(app, origins='*')  # or restrict to localhost:3000
+  ```
+- **Project Setup**:
+  - Use `create-react-app`
+  - Include: `react-admin`, `@mui/material`, `@emotion/react`, `@emotion/styled`, `react-router-dom`
+  - Do not use any deprecated or unmaintained libraries
+  - Include complete and correct `App.js`, `index.js`, `dataProvider.js`, and `index.html`
+
+---
+
+### Per-Resource Files (Required)
+
+For each resource (`Customer`, `Order` etc):
+- Create a source file under `src/`, e.g., `Customer.js`
+- **Each file must fully implement**:
+  - `CustomerList`
+  - `CustomerShow`
+  - `CustomerCreate`
+  - `CustomerEdit`
+
+Use:
+- `<ReferenceField>` for foreign key displays
+- `<ReferenceInput>` for foreign key input
+- `<ReferenceManyField>` for tabbed child lists
+- For show pages
+  - Always start with <SimpleShowLayout>, followed by a <TabbedShowLayout> for related data
+    - DO NOT start with <TabbedShowLayout>
+
+Be sure to include all required imports.  ALWAYS use the following AS IS, plus whatever else is required:
+
+```jsx
+import { List, FunctionField, Datagrid, TextField, DateField, NumberField, ReferenceField, ReferenceManyField, Show, TabbedShowLayout, Tab, SimpleShowLayout, TextInput, NumberInput, DateTimeInput, ReferenceInput, SelectInput, Create, SimpleForm, Edit, Filter, Pagination, BooleanField, BooleanInput } from 'react-admin';
+```
+You may add other imports, but be sure all those are included.
+
+DO NOT use <EmailInput> - use <TextInput>.
+
+DO NOT put <ReferenceField> in <Datagrid>.
+
+Do **not leave any file empty**.
+
+---
+
+### App Wiring
+
+Sample code for `App.js`:
+
+
+```jsx
+import React from 'react';
+import { Admin, Resource } from 'react-admin';
+import { createTheme } from '@mui/material/styles';
+
+// import each resource
+import { CustomerList, CustomerShow, CustomerCreate, CustomerEdit } from './Customer';
+...
+// import the data provider
+import { dataProvider } from './dataProvider';
+
+const theme = createTheme({
+    palette: {
+        primary: { main: '#1976d2' },    // Material-UI default blue
+        secondary: { main: '#1565c0' },  // A darker blue, or choose another color
+    },
+    typography: { fontSize: 14 },
+});
+
+const App = () => {
+    return (
+        <Admin dataProvider={dataProvider}>  // register each resource...
+            <Resource name="Customer" list={CustomerList} show={CustomerShow} edit={CustomerEdit} create={CustomerCreate} />
+...
+        </Admin>
+    );
+};
+
+export default App;
+```
+
+For dataProvider:
+1 - be sure it includes the braces: import { dataProvider }
+2 - Do Not generate either:
+```jsx
+import jsonServerProvider from 'ra-data-json-server'
+const dataProvider = jsonServerProvider('http://api.example.com');
+```
+
+---
+
+## Response Format
+
+Format the response as a JSResponseFormat:
+
+class JSResponseFormat(BaseModel):  # must match system/genai/prompt_inserts/response_format.prompt
+    code : str # generated javascript code (only)

api_logic_server_cli/prototypes/manager/system/genai/app_templates/app_learning/notes.md

@@ -0,0 +1,7 @@
+Discussions:
+* How to install the grid for multi-field rows
+* Validation errors
+* Security
+* dataProvider
+* size; use api_logic_server_cli/create_from_model/safrs-react-admin-npm-build?
+

api_logic_server_cli/prototypes/manager/system/genai/app_templates/react-admin-template/README.md

@@ -0,0 +1,17 @@
+# Getting Started with Genai-Logic react-admin
+
+This project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app).  For more information, see [README_create_react_app](README_create_react_app.md).
+
+GenAI-Logic (`als genai-app`) then [created this project](https://apilogicserver.github.io/Docs/Admin-Vibe/).
+
+<br>
+
+# To run the app:
+
+```bash
+cd ui/react-admin
+npm install
+npm start
+```
+
+Open your browser at [http://localhost:3000](http://localhost:3000).

api_logic_server_cli/prototypes/manager/system/genai/app_templates/react-admin-template/README_create_react_app.md

@@ -0,0 +1,70 @@
+# Getting Started with Create React App
+
+This project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app).
+
+## Available Scripts
+
+In the project directory, you can run:
+
+### `npm start`
+
+Runs the app in the development mode.\
+Open [http://localhost:3000](http://localhost:3000) to view it in your browser.
+
+The page will reload when you make changes.\
+You may also see any lint errors in the console.
+
+### `npm test`
+
+Launches the test runner in the interactive watch mode.\
+See the section about [running tests](https://facebook.github.io/create-react-app/docs/running-tests) for more information.
+
+### `npm run build`
+
+Builds the app for production to the `build` folder.\
+It correctly bundles React in production mode and optimizes the build for the best performance.
+
+The build is minified and the filenames include the hashes.\
+Your app is ready to be deployed!
+
+See the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.
+
+### `npm run eject`
+
+**Note: this is a one-way operation. Once you `eject`, you can't go back!**
+
+If you aren't satisfied with the build tool and configuration choices, you can `eject` at any time. This command will remove the single build dependency from your project.
+
+Instead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except `eject` will still work, but they will point to the copied scripts so you can tweak them. At this point you're on your own.
+
+You don't have to ever use `eject`. The curated feature set is suitable for small and middle deployments, and you shouldn't feel obligated to use this feature. However we understand that this tool wouldn't be useful if you couldn't customize it when you are ready for it.
+
+## Learn More
+
+You can learn more in the [Create React App documentation](https://facebook.github.io/create-react-app/docs/getting-started).
+
+To learn React, check out the [React documentation](https://reactjs.org/).
+
+### Code Splitting
+
+This section has moved here: [https://facebook.github.io/create-react-app/docs/code-splitting](https://facebook.github.io/create-react-app/docs/code-splitting)
+
+### Analyzing the Bundle Size
+
+This section has moved here: [https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size](https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size)
+
+### Making a Progressive Web App
+
+This section has moved here: [https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app](https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app)
+
+### Advanced Configuration
+
+This section has moved here: [https://facebook.github.io/create-react-app/docs/advanced-configuration](https://facebook.github.io/create-react-app/docs/advanced-configuration)
+
+### Deployment
+
+This section has moved here: [https://facebook.github.io/create-react-app/docs/deployment](https://facebook.github.io/create-react-app/docs/deployment)
+
+### `npm run build` fails to minify
+
+This section has moved here: [https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify](https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify)