dev-demo: agent images AdminForth/1955/implement-ability-for-agent-pl

attachments column of the turns with the Upload plugin on it (local or
S3 storage with strictContentType), attachmentsField of the agent, and
read-only turns and checkpoints.

Author: srelon

dev-demo/globalPlugins.ts

@@ -107,6 +107,7 @@ export const globalPlugins = [
       responseField: 'response',
       debugField: 'dubbug',
       checkpointIdField: 'checkpoint_id',
+      attachmentsField: 'attachments',
     },
     checkpointResource: {
       resourceId: 'agent_checkpoints',

dev-demo/migrations/prisma/sqlite/migrations/20261028120000_add_turns_attachments_field/migration.sql

@@ -0,0 +1 @@
+ALTER TABLE "turns" ADD COLUMN "attachments" TEXT;

dev-demo/migrations/prisma/sqlite/schema.prisma

@@ -164,6 +164,7 @@ model turns {
   response      String?
   dubbug        String?
   checkpoint_id String?
+  attachments   String?
 }
 
 model agent_checkpoints {

dev-demo/resources/agent_resources/checkpoints.ts

@@ -8,6 +8,14 @@ export default {
   table: 'agent_checkpoints',
   resourceId: 'agent_checkpoints',
   label: 'Agent Checkpoints',
+  // written by the agent only; edits here would bypass its checks and its file bookkeeping
+  options: {
+    allowedActions: {
+      create: false,
+      edit: false,
+      delete: false,
+    },
+  },
   columns: [
     { name: 'id', primaryKey: true, type: AdminForthDataTypes.STRING },
     { name: 'thread_id', type: AdminForthDataTypes.STRING },

dev-demo/resources/agent_resources/turns.ts

@@ -1,12 +1,23 @@
 import AdminForth, { AdminForthDataTypes } from 'adminforth';
 import type { AdminForthResourceInput, AdminUser } from 'adminforth';
 import { randomUUID } from 'crypto';
+import UploadPlugin from '../../../plugins/adminforth-upload/index.js';
+import AdminForthStorageAdapterLocalFilesystem from '../../../adapters/adminforth-storage-adapter-local/index.js';
+import AdminForthAdapterS3Storage from '../../../adapters/adminforth-storage-adapter-amazon-s3/index.js';
 
 export default {
   dataSource: 'sqlite',
   table: 'turns',
   resourceId: 'turns',
   label: 'Turns',
+  // written by the agent only; edits here would bypass its checks and its file bookkeeping
+  options: {
+    allowedActions: {
+      create: false,
+      edit: false,
+      delete: false,
+    },
+  },
   columns: [
     {
       name: 'id',
@@ -70,5 +81,39 @@ export default {
         filter: false,
       },
     },
+    {
+      name: 'attachments',
+      type: AdminForthDataTypes.JSON,
+      isArray: {
+        enabled: true,
+        itemType: AdminForthDataTypes.STRING,
+      },
+      showIn: {
+        list: false,
+        show: true,
+        edit: false,
+        create: false,
+        filter: false,
+      },
+    },
+  ],
+  plugins: [
+    new UploadPlugin({
+      pathColumnName: 'attachments',
+      storageAdapter: process.env.USE_S3 !== 'true' ? new AdminForthStorageAdapterLocalFilesystem({
+        fileSystemFolder: './db/uploads_agent_attachments',
+        mode: 'private',
+        signingSecret: '1241245',
+      }) : new AdminForthAdapterS3Storage({
+        bucket: process.env.AWS_BUCKET_NAME as string,
+        region: process.env.AWS_REGION as string,
+        accessKeyId: process.env.AWS_ACCESS_KEY_ID as string,
+        secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY as string,
+        strictContentType: true,
+      }),
+      allowedFileExtensions: ['png', 'jpg', 'jpeg', 'webp'],
+      maxFileSize: 1024 * 1024 * 5,
+      filePath: ({ originalExtension }) => `agent_attachments/${randomUUID()}.${originalExtension}`,
+    }),
   ],
 } as AdminForthResourceInput;