Merge branch 'next' of github.com:devforth/adminforth into next

Author: SerVitasik

README.md

@@ -5,7 +5,7 @@
 
 [![Ask AI](http://tluma.ai/badge)](http://tluma.ai/ask-ai/devforth/adminforth)
 
-* [Try live demo](https://demo.adminforth.dev/)  (Read-only mode)
+* [Try live demo](https://demo.adminforth.dev/) 
 
 * [Hello world in 5 minutes](https://adminforth.dev/docs/tutorial/gettingStarted) with AdminForth
 

adminforth/commands/createPlugin/templates/types.ts.hbs

@@ -1,3 +1,5 @@
-export interface PluginOptions {
+import  {type PluginsCommonOptions } from "adminforth";
+
+export interface PluginOptions extends PluginsCommonOptions {
 
 }

adminforth/documentation/docs/tutorial/08-Plugins/26-agent.md

@@ -5,7 +5,7 @@
 
 This plugin adds an AI agent with a chat surface to AdminForth which is capable of default skills like searching/editing data and extending with custom skills. 
 
-It stores session history in your own resources and uses any AdminForth completion adapter to generate responses.
+It stores session history in your own resources and generates responses using one of the configured `modes`.
 
 ## Installation
 
@@ -21,17 +21,21 @@ Add your LLM credentials to `.env`:
 OPENAI_API_KEY=your_key
 ```
 
-You can replace the OpenAI adapter with any completion adapter from [List of adapters](/docs/tutorial/ListOfAdapters/).
+Each mode accepts any AdminForth completion adapter, so you can replace the OpenAI adapter with another adapter from [List of adapters](/docs/tutorial/ListOfAdapters/).
 
 ## Setup
 
 First create two resources for sessions and turns:
 
 ```ts title="./resources/agent_resources/sessions.ts"
 import AdminForth, { AdminForthDataTypes } from 'adminforth';
-import type { AdminForthResourceInput } from 'adminforth';
+import type { AdminForthResourceInput, AdminUser } from 'adminforth';
 import { randomUUID } from 'crypto';
 
+async function allowedForSuperAdmins({ adminUser }: { adminUser: AdminUser }): Promise<boolean> {
+  return adminUser.dbUser.role === 'superadmin';
+}
+
 export default {
   dataSource: 'sqlite',
   table: 'sessions',
@@ -70,14 +74,27 @@ export default {
       },
     },
   ],
+  options: {
+    allowedActions: {
+      list: allowedForSuperAdmins,
+      show: allowedForSuperAdmins,
+      create: false,
+      edit: false,
+      delete: false,
+    },
+  },
 } as AdminForthResourceInput;
 ```
 
 ```ts title="./resources/agent_resources/turns.ts"
 import AdminForth, { AdminForthDataTypes } from 'adminforth';
-import type { AdminForthResourceInput } from 'adminforth';
+import type { AdminForthResourceInput, AdminUser } from 'adminforth';
 import { randomUUID } from 'crypto';
 
+async function allowedForSuperAdmins({ adminUser }: { adminUser: AdminUser }): Promise<boolean> {
+  return adminUser.dbUser.role === 'superadmin';
+}
+
 export default {
   dataSource: 'sqlite',
   table: 'turns',
@@ -116,6 +133,15 @@ export default {
       type: AdminForthDataTypes.TEXT,
     },
   ],
+  options: {
+    allowedActions: {
+      list: allowedForSuperAdmins,
+      show: allowedForSuperAdmins,
+      create: false,
+      edit: false,
+      delete: false,
+    },
+  },
 } as AdminForthResourceInput;
 ```
 
@@ -166,6 +192,8 @@ export const admin = new AdminForth({
 
 Then attach the plugin once, usually to your `adminuser` resource:
 
+Configure the plugin with `modes`. The legacy top-level `completionAdapter` setup is no longer used.
+
 ```ts title="./resources/adminuser.ts"
 import AdminForthAgent from '@adminforth/agent';
 import CompletionAdapterOpenAIChatGPT from '@adminforth/completion-adapter-open-ai-chat-gpt';
@@ -175,12 +203,45 @@ import CompletionAdapterOpenAIChatGPT from '@adminforth/completion-adapter-open-
 plugins: [
   ...
   new AdminForthAgent({
-    completionAdapter: new CompletionAdapterOpenAIChatGPT({
-      openAiApiKey: process.env.OPENAI_API_KEY as string,
-      model: 'gpt-5.4-mini',
-    }),
+    modes: [
+      {
+        name: 'Balanced',
+        completionAdapter: new CompletionAdapterOpenAIChatGPT({
+          openAiApiKey: process.env.OPENAI_API_KEY as string,
+          model: 'gpt-5.4-mini',
+          extraRequestBodyParameters: {
+            reasoning: {
+              effort: 'medium',
+            },
+          },
+        }),
+      },
+      {
+        name: 'Fast',
+        completionAdapter: new CompletionAdapterOpenAIChatGPT({
+          openAiApiKey: process.env.OPENAI_API_KEY as string,
+          model: 'gpt-5.4-mini',
+          extraRequestBodyParameters: {
+            reasoning: {
+              effort: 'low',
+            },
+          },
+        }),
+      },
+      {
+        name: 'Smart Thinking',
+        completionAdapter: new CompletionAdapterOpenAIChatGPT({
+          openAiApiKey: process.env.OPENAI_API_KEY as string,
+          model: 'gpt-5.4',
+          extraRequestBodyParameters: {
+            reasoning: {
+              effort: 'xhigh',
+            },
+          },
+        }),
+      },
+    ],
     maxTokens: 10000,
-    reasoning: 'none',
     sessionResource: {
       resourceId: 'sessions',
       idField: 'id',
@@ -203,7 +264,9 @@ plugins: [
 ]
 ```
 
-The plugin adds a chat surface to the admin UI and keeps session history per admin user.
+Each item in `modes` defines a user-selectable preset in the chat UI. The selected mode is sent to the backend and the plugin uses that mode's `completionAdapter` for the response.
+
+The plugin adds a chat surface to the admin UI, keeps session history per admin user, and shows a mode picker when `modes` are configured.
 
 ## Reverse proxy and CDN configuration for streaming
 
@@ -270,5 +333,3 @@ In skills markdown file, merge which tool exactlu agent should load.
 Skill example:
 
 // TODO
-
-

adminforth/documentation/docs/tutorial/09-Advanced/01-plugin-development.md

@@ -60,8 +60,9 @@ In plugin options we will pass field name and `OPENAI_API_KEY`.
 
 
 ```ts title='./af-plugin-chatgpt/types.ts'
+import  {type PluginsCommonOptions } from "adminforth";
 
-export interface PluginOptions {
+export interface PluginOptions extends PluginsCommonOptions {
 
 //diff-add
   /**
@@ -557,9 +558,9 @@ To use adapter in plugin you should define it in plugin options:
 
 ```ts title='./af-plugin-any-complete/types.ts'
 
-import { CompletionAdapter } from "adminforth";
+import { CompletionAdapter, type PluginsCommonOptions } from "adminforth";
 
-export interface PluginOptions {
+export interface PluginOptions extends PluginsCommonOptions{
   ...
 
 //diff-add

adminforth/documentation/src/css/custom.css

@@ -130,17 +130,17 @@ pre code:has(.code-block-diff-remove-line) {
   position: relative;
   z-index: 1;
   padding: 3%;
+  overflow: hidden;
   border-radius: 2vw;
   background: #ecf1f7;
   background-image: linear-gradient(to bottom, #333, #111);
   box-shadow: 0 0.1rem 0 #cfcfcf;
   border: 2px solid #ccc;
 }
-.laptop .laptop__screen img {
+.laptop .laptop__screen img,
+.laptop .laptop__screen iframe {
   display: block;
   max-width: 100%;
-  height: auto;
-  aspect-ratio: attr(width) / attr(height);
   background: #000;
 }
 .laptop .laptop__bottom {

adminforth/documentation/src/pages/index.module.css

@@ -36,16 +36,22 @@
   max-width: 500px;
 }
 
+.demoFrame {
+  display: block;
+  width: 100%;
+  aspect-ratio: 16 / 10;
+  border: 0;
+  border-radius: 1.2vw;
+  background: #000;
+}
+
 .cardsWrapper {
   display: grid;
-  grid-template-columns: repeat(3, minmax(300px, 500px));
+  grid-template-columns: repeat(2, minmax(300px, 500px));
   gap: 4rem;
   justify-content: center;
   padding: 1rem;
 
-  @media (max-width: 1200px) {
-    grid-template-columns: repeat(2, minmax(300px, 500px));
-  }
   @media (max-width: 768px) {
     grid-template-columns: repeat(1, minmax(300px, 500px));
   }