Merge branch 'main' into next

Author: ivictbor

adminforth/dataConnectors/baseConnector.ts

@@ -167,6 +167,11 @@ export default class AdminForthBaseConnector implements IAdminForthDataSourceCon
       }
       const fieldObj = resource.dataSourceColumns.find((col) => col.name == normalizedFilter.field);
       if (!fieldObj) {
+        const resourceColumn = resource.columns.find((col) => col.name == normalizedFilter.field);
+        if (resourceColumn?.virtual) {
+          return { ok: true, error: '', normalizedFilters: normalizedFilter };
+        }
+
         const similar = suggestIfTypo(resource.dataSourceColumns.map((col) => col.name), normalizedFilter.field);
 
         let isPolymorphicTarget = false;
@@ -191,6 +196,11 @@ export default class AdminForthBaseConnector implements IAdminForthDataSourceCon
         // ensure rightField exists in resource
         const rightFieldObj = resource.dataSourceColumns.find((col) => col.name == normalizedFilter.rightField);
         if (!rightFieldObj) {
+          const rightResourceColumn = resource.columns.find((col) => col.name == normalizedFilter.rightField);
+          if (rightResourceColumn?.virtual) {
+            return { ok: true, error: '', normalizedFilters: normalizedFilter };
+          }
+
           const similar = suggestIfTypo(resource.dataSourceColumns.map((col) => col.name), normalizedFilter.rightField as string);
           throw new Error(`Field '${normalizedFilter.rightField}' not found in resource '${resource.resourceId}'. ${similar ? `Did you mean '${similar}'?` : ''}`);
         }

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

@@ -314,7 +314,41 @@ completionAdapter: new CompletionAdapterOpenAIResponses({
 OVH AI Endpoints still does not fully support the OpenAI `responses` API, so `useComplitionApi: false` may work unstably there.
 
 
+## Turn on audio chat support
+If you want to have an ability to talk with agent usng voice, you can setup it:
 
+1) Install audio adapter:
+
+```bash
+pnpm add @adminforth/audio-adapter-openai
+```
+
+2) Import it in your users resource and add to the plugin config
+
+```ts title="./resources/adminuser.ts"
+  //diff-add
+  import OpenAIAudioAdapter from '@adminforth/audio-adapter-openai'
+
+  ...
+
+
+  new AdminForthAgent({
+    ...
+    //diff-add
+    audioAdapter: new OpenAIAudioAdapter({
+      //diff-add
+      apiKey: process.env.OPENAI_API_KEY as string,,
+      //diff-add
+      defaultVoice: 'alloy',
+      //diff-add
+      defaultSpeed: 1.25,
+    //diff-add
+    }),
+    ...
+  }),
+  ...
+
+```
 
 ## Writing own skills
 

dev-demo/custom/AfComponents.vue

@@ -12,7 +12,7 @@
         :loader="false" class="w-full" mode="secondary">
         Secondary button
       </Button>
-
+ 
       <Button @click="doSmth" 
           :loader="true" class="w-full mt-4">
         Your button text

dev-demo/index.ts

@@ -58,7 +58,7 @@ export const admin = new AdminForth({
       }
       const imageUrl = await plugin.getFileDownloadUrl(adminUser.dbUser.avatar || '', 3600);
       return imageUrl;
-    },
+    }, 
   },
   customization: {
     brandName: "dev-demo",
@@ -278,7 +278,7 @@ if (fileURLToPath(import.meta.url) === path.resolve(process.argv[1])) {
   admin.bundleNow({ hotReload: process.env.NODE_ENV === 'development' }).then(() => {
     logger.info('Bundling AdminForth SPA done.');
   });
-
+ 
   admin.express.serve(app);
 
   const backgroundJobsPlugin = admin.getPluginByClassName<BackgroundJobsPlugin>('BackgroundJobsPlugin');

live-demo/app/Dockerfile

@@ -1,8 +1,8 @@
 FROM node:20-alpine
 WORKDIR /code/
 ADD package.json pnpm-lock.yaml pnpm-workspace.yaml /code/
-RUN npm i -g corepack@0.31.0
 RUN corepack enable
+RUN corepack prepare pnpm@latest-10 --activate
 RUN pnpm i  
 ADD . /code/
 RUN pnpm bundleNow

live-demo/app/index.ts

@@ -1,13 +1,15 @@
-import betterSqlite3 from 'better-sqlite3';
 import express from 'express';
-import AdminForth, { AdminForthDataTypes, Filters,  AdminForthResource, AdminForthResourceColumn  } from 'adminforth';
+import type { Request, Response } from 'express';
+import AdminForth, { Filters } from 'adminforth';
+import type { AdminUser } from 'adminforth';
 import fs from 'fs';
 import usersResource from "./resources/users";
 import apartmentsResource from "./resources/apartments";
 import auditLogsResource from "./resources/auditLogs"
 import translations from "./resources/translations";
 import sessionsResource from './resources/agent_resources/sessions';
 import turnsResource from './resources/agent_resources/turns';
+import checkpointsResource from './resources/agent_resources/checkpoints';
 import jobs_resource from './resources/jobs';
 import { randomUUID } from 'crypto';
 try { fs.mkdirSync('db') } catch (e) {} 
@@ -66,6 +68,7 @@ new AdminForth({
     translations,
     sessionsResource,
     turnsResource,
+    checkpointsResource,
     jobs_resource,
   ],
   menu: [
@@ -179,7 +182,7 @@ if (import.meta.url === `file://${process.argv[1]}`) {
         },
       },
       admin.express.authorize(
-        async (req, res) => {
+        async (req: Request, res: Response) => {
         const db = admin.resource('aparts').dataConnector.client;
         const days = req.body.days || 7;
         const apartsByDays = await db.prepare(

live-demo/app/migrations/20260507110000_add_agent_checkpoints/migration.sql

@@ -0,0 +1,22 @@
+-- CreateTable
+CREATE TABLE "agent_checkpoints" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "thread_id" TEXT NOT NULL,
+    "checkpoint_namespace" TEXT NOT NULL,
+    "checkpoint_id" TEXT NOT NULL,
+    "parent_checkpoint_id" TEXT,
+    "row_kind" TEXT NOT NULL,
+    "task_id" TEXT,
+    "sequence" INTEGER NOT NULL,
+    "created_at" DATETIME NOT NULL,
+    "checkpoint_payload" TEXT,
+    "metadata_payload" TEXT,
+    "writes_payload" TEXT,
+    "schema_version" INTEGER NOT NULL
+);
+
+-- CreateIndex
+CREATE INDEX "agent_checkpoints_thread_id_checkpoint_namespace_checkpoint_id_idx" ON "agent_checkpoints"("thread_id", "checkpoint_namespace", "checkpoint_id");
+
+-- CreateIndex
+CREATE INDEX "agent_checkpoints_created_at_idx" ON "agent_checkpoints"("created_at");