feat: replace OpenAI ChatGPT adapter with OpenAI Responses adapter across documentation and codebase

ivictbor · Copilot · ivictbor · commit e27b8e4de37e · 2026-04-23T10:25:01.000Z
Co-authored-by: Copilot &lt;copilot@github.com&gt;
diff --git a/AGENTS.md b/AGENTS.md
@@ -1,6 +1,11 @@
 
 # AGENTS.md
 
+## Package manager
+
+All packages and projects in this repo use `pnpm` and not `npm`. 
+Howeverer internally (e.g. in `codeInjector`) adminforth still supports both `npm` and `pnpm` style install commands, so users of framework itself can use it with either package manager. But in all dev demo/live demo, plugins, adapters, and documentation, we use `pnpm` as the standard.
+
 ## General engineering rules
 
 Write code as if the system contracts are already defined and trusted.
diff --git a/adminforth/documentation/blog/2024-10-01-ai-blog/index.md b/adminforth/documentation/blog/2024-10-01-ai-blog/index.md
@@ -47,7 +47,7 @@ Add modules:
 
 ```bash
 cd ai-blog
-npm i @adminforth/upload @adminforth/rich-editor @adminforth/text-complete @adminforth/chat-gpt slugify http-proxy @adminforth/image-generation-adapter-openai @adminforth/completion-adapter-open-ai-chat-gpt
+npm i @adminforth/upload @adminforth/rich-editor @adminforth/text-complete @adminforth/chat-gpt slugify http-proxy @adminforth/image-generation-adapter-openai @adminforth/completion-adapter-openai-responses
 ```
 
 
@@ -475,7 +475,7 @@ import UploadPlugin from '@adminforth/upload';
 import RichEditorPlugin from '@adminforth/rich-editor';
 import ChatGptPlugin from '@adminforth/chat-gpt';
 import slugify from 'slugify';
-import CompletionAdapterOpenAIChatGPT from "@adminforth/completion-adapter-open-ai-chat-gpt";
+import CompletionAdapterOpenAIResponses from "@adminforth/completion-adapter-openai-responses";
 import ImageGenerationAdapterOpenAI from '@adminforth/image-generation-adapter-openai';
 
 export default {
@@ -591,7 +591,7 @@ export default {
     new RichEditorPlugin({
       htmlFieldName: 'content',
       completion: {
-        adapter: new CompletionAdapterOpenAIChatGPT({
+        adapter: new CompletionAdapterOpenAIResponses({
           openAiApiKey: process.env.OPENAI_API_KEY as string,
           model: 'gpt-4o',
           expert: {
diff --git a/adminforth/documentation/docs/tutorial/05-ListOfAdapters.md b/adminforth/documentation/docs/tutorial/05-ListOfAdapters.md
@@ -154,18 +154,20 @@ Not really recommended for production use, cause cloud storage is more reliable
 Is used for AI-powered text completion. 
 Feel free to fork and implement other models including models from Anthropic, Google Gemini, or any other AI model that supports text completion.
 
-### OpenAI Completion Adapter
+### OpenAI Responses Completion Adapter
 
 ```
-pnpm i @adminforth/completion-adapter-open-ai-chat-gpt
+pnpm i @adminforth/completion-adapter-openai-responses
 ```
 
-Integrates AdminForth with OpenAI’s ChatGPT models to provide AI-powered completion and conversational features.
+Integrates AdminForth with OpenAI's Responses API to provide AI-powered completion and conversational features.
+
+The older `@adminforth/completion-adapter-open-ai-chat-gpt` package is deprecated. Use this package instead.
 
 ```ts
-import CompletionAdapterOpenAIChatGPT from "@adminforth/completion-adapter-open-ai-chat-gpt";
+import CompletionAdapterOpenAIResponses from "@adminforth/completion-adapter-openai-responses";
 
-new CompletionAdapterOpenAIChatGPT({
+new CompletionAdapterOpenAIResponses({
   openAiApiKey: process.env.OPENAI_API_KEY as string,
   model: 'gpt-5.2',
   extraRequestBodyParameters: {
@@ -259,7 +261,7 @@ If you want to use a custom `json_schema` for completion response, pass it as `o
 
 
 ```ts
-const openAi = new CompletionAdapterOpenAIChatGPT({
+const openAi = new CompletionAdapterOpenAIResponses({
   openAiApiKey: process.env.OPENAI_API_KEY as string,
   model: 'gpt-5-mini',
 });
@@ -290,7 +292,7 @@ openAi.complete(
 If you want to explicitly test a reasoning-capable GPT-5 model, pass `reasoningEffort` as the 4th argument:
 
 ```ts
-const openAi = new CompletionAdapterOpenAIChatGPT({
+const openAi = new CompletionAdapterOpenAIResponses({
   openAiApiKey: process.env.OPENAI_API_KEY as string,
   model: "gpt-5-mini",
 });
@@ -310,7 +312,7 @@ console.log(resp.content);
 If you pass `onChunk`, adapter switches to streaming mode automatically:
 
 ```ts
-const openAi = new CompletionAdapterOpenAIChatGPT({
+const openAi = new CompletionAdapterOpenAIResponses({
   openAiApiKey: process.env.OPENAI_API_KEY as string,
   model: "gpt-5-mini",
 });
diff --git a/adminforth/documentation/docs/tutorial/08-Plugins/04-RichEditor.md b/adminforth/documentation/docs/tutorial/08-Plugins/04-RichEditor.md
@@ -106,21 +106,21 @@ If you need multiple fields in one resource which happens rarely, just add multi
 First, install the completion adapter:
 
 ```bash
-pnpm i @adminforth/completion-adapter-open-ai-chat-gpt --save
+pnpm i @adminforth/completion-adapter-openai-responses --save
 ```
 
 To get completion suggestions for the text in the editor, you can use the `completion` option. This option is an object with the following properties:
 
 ```ts title="./resources/apartments.ts"
 //diff-add
-  import CompletionAdapterOpenAIChatGPT from "@adminforth/completion-adapter-open-ai-chat-gpt";
+  import CompletionAdapterOpenAIResponses from "@adminforth/completion-adapter-openai-responses";
 
   new RichEditorPlugin({
       htmlFieldName: 'description',
 //diff-add
       completion: {
 //diff-add
-        adapter: new CompletionAdapterOpenAIChatGPT({
+        adapter: new CompletionAdapterOpenAIResponses({
 //diff-add
           openAiApiKey: process.env.OPENAI_API_KEY as string,
 //diff-add
diff --git a/adminforth/documentation/docs/tutorial/08-Plugins/06-text-complete.md b/adminforth/documentation/docs/tutorial/08-Plugins/06-text-complete.md
@@ -1,12 +1,12 @@
 # Text Complete
 
-This plugin allows you to auto-complete text and string fields using OpenAI Chat GPT models.
+This plugin allows you to auto-complete text and string fields using OpenAI GPT models via the Responses API.
 
 ## Installation
 
 ```
 pnpm i @adminforth/text-complete --save
-pnpm i @adminforth/completion-adapter-open-ai-chat-gpt --save
+pnpm i @adminforth/completion-adapter-openai-responses --save
 ```
 
 Go to https://platform.openai.com/, open `Dashboard` -> `API keys` -> `Create new secret key`. Paste value in your `.env` file:
@@ -24,7 +24,7 @@ For example let's add it for title and description in `aparts` resource configur
 //diff-add
 import TextCompletePlugin from '@adminforth/text-complete';
 //diff-add
-import CompletionAdapterOpenAIChatGPT from "@adminforth/completion-adapter-open-ai-chat-gpt";
+import CompletionAdapterOpenAIResponses from "@adminforth/completion-adapter-openai-responses";
 
 
 export const admin = new AdminForth({
@@ -40,7 +40,7 @@ export const admin = new AdminForth({
 //diff-add
       fieldName: 'title',
 //diff-add
-      adapter: new CompletionAdapterOpenAIChatGPT({
+      adapter: new CompletionAdapterOpenAIResponses({
 //diff-add
         openAiApiKey: process.env.OPENAI_API_KEY as string,
 //diff-add
@@ -60,7 +60,7 @@ export const admin = new AdminForth({
 //diff-add
       fieldName: 'description',
 //diff-add
-      adapter: new CompletionAdapterOpenAIChatGPT({
+      adapter: new CompletionAdapterOpenAIResponses({
 //diff-add
         openAiApiKey: process.env.OPENAI_API_KEY as string,
 //diff-add
diff --git a/adminforth/documentation/docs/tutorial/08-Plugins/10-i18n.md b/adminforth/documentation/docs/tutorial/08-Plugins/10-i18n.md
@@ -3,7 +3,7 @@
 This plugin allows you translate your AdminForth application to multiple languages.
 Main features:
 - Stores all translation strings in your application in a single AdminForth resource. You can set [allowed actions](/docs/tutorial/Customization/limitingAccess/) only  to Developers/Translators role if you don't want other users to see/edit the translations.
-- Supports AI completion adapters to help with translations. For example, you can use OpenAI ChatGPT to generate translations. Supports correct pluralization, even for Slavic languages.
+- Supports AI completion adapters to help with translations. For example, you can use OpenAI via the Responses API to generate translations. Supports correct pluralization, even for Slavic languages.
 - Supports any number of languages.
 - Supports BCP47 language codes (e.g., `en-GB`, `pt-BR`) for regional language variants.
 - Configurable primary language.
@@ -18,7 +18,7 @@ To install the plugin:
 
 ```bash
 pnpm install @adminforth/i18n --save
-pnpm install @adminforth/completion-adapter-open-ai-chat-gpt --save
+pnpm install @adminforth/completion-adapter-openai-responses --save
 ```
 
 For example lets add translations to next 4 languages: Ukrainian, Japanese, French, Spanish. Also we will support basic translation for English.
@@ -56,7 +56,7 @@ Next, add resource for translations:
 ```ts title='./resources/translations.ts'
 
 import AdminForth, { AdminForthDataTypes, AdminForthResourceInput } from "adminforth";
-import CompletionAdapterOpenAIChatGPT from "@adminforth/completion-adapter-open-ai-chat-gpt";
+import CompletionAdapterOpenAIResponses from "@adminforth/completion-adapter-openai-responses";
 import I18nPlugin from "@adminforth/i18n";
 import { randomUUID } from 'crypto';
 
@@ -96,7 +96,7 @@ export default {
       // optional: set primary language (defaults to 'en' if not specified)
       // primaryLanguage: 'fr', // Uncomment to set French as primary language
 
-      completeAdapter: new CompletionAdapterOpenAIChatGPT({
+      completeAdapter: new CompletionAdapterOpenAIResponses({
         openAiApiKey: process.env.OPENAI_API_KEY as string,
         model: 'gpt-5-nano',
         extraRequestBodyParameters: {
diff --git a/adminforth/documentation/docs/tutorial/08-Plugins/17-bulk-ai-flow.md b/adminforth/documentation/docs/tutorial/08-Plugins/17-bulk-ai-flow.md
@@ -199,12 +199,12 @@ This is the most basic plugin usage. You can connect any text completion adapter
 Normalize user names by translating them from any language to English for internal processing.
 
 ```ts
-import CompletionAdapterOpenAIChatGPT from '@adminforth/completion-adapter-open-ai-chat-gpt/index.js';
+import CompletionAdapterOpenAIResponses from '@adminforth/completion-adapter-openai-responses';
 
 // Add to your resource plugins array
 new BulkAiFlowPlugin({
   actionName: 'Translate surnames',
-  textCompleteAdapter: new CompletionAdapterOpenAIChatGPT({
+  textCompleteAdapter: new CompletionAdapterOpenAIResponses({
     openAiApiKey: process.env.OPENAI_API_KEY as string,
     model: 'gpt-5-nano',
     extraRequestBodyParameters: {
diff --git a/adminforth/documentation/docs/tutorial/08-Plugins/26-agent.md b/adminforth/documentation/docs/tutorial/08-Plugins/26-agent.md
@@ -11,7 +11,7 @@ It stores session history in your own resources and generates responses using on
 
 ```bash
 pnpm i @adminforth/agent --save
-pnpm i @adminforth/completion-adapter-open-ai-chat-gpt --save
+pnpm i @adminforth/completion-adapter-openai-responses --save
 ```
 
 Add your LLM credentials to `.env`:
@@ -196,7 +196,7 @@ Configure the plugin with `modes`. The legacy top-level `completionAdapter` setu
 
 ```ts title="./resources/adminuser.ts"
 import AdminForthAgent from '@adminforth/agent';
-import CompletionAdapterOpenAIChatGPT from '@adminforth/completion-adapter-open-ai-chat-gpt';
+import CompletionAdapterOpenAIResponses from '@adminforth/completion-adapter-openai-responses';
 
 ...
 
@@ -213,7 +213,7 @@ plugins: [
     modes: [
       {
         name: 'Balanced',
-        completionAdapter: new CompletionAdapterOpenAIChatGPT({
+        completionAdapter: new CompletionAdapterOpenAIResponses({
           openAiApiKey: process.env.OPENAI_API_KEY as string,
           model: 'gpt-5.4-mini',
           extraRequestBodyParameters: {
@@ -225,7 +225,7 @@ plugins: [
       },
       {
         name: 'Fast',
-        completionAdapter: new CompletionAdapterOpenAIChatGPT({
+        completionAdapter: new CompletionAdapterOpenAIResponses({
           openAiApiKey: process.env.OPENAI_API_KEY as string,
           model: 'gpt-5.4-mini',
           extraRequestBodyParameters: {
@@ -237,7 +237,7 @@ plugins: [
       },
       {
         name: 'Smart Thinking',
-        completionAdapter: new CompletionAdapterOpenAIChatGPT({
+        completionAdapter: new CompletionAdapterOpenAIResponses({
           openAiApiKey: process.env.OPENAI_API_KEY as string,
           model: 'gpt-5.4',
           extraRequestBodyParameters: {
diff --git a/dev-demo/Taskfile.yaml b/dev-demo/Taskfile.yaml
@@ -34,7 +34,6 @@ vars:
     - "adminforth-agent"
 
   ADAPTERS:
-    - "adminforth-completion-adapter-open-ai-chat-gpt"
     - "adminforth-email-adapter-aws-ses"
     - "adminforth-email-adapter-mailgun"
     - "adminforth-oauth-adapter-google"
@@ -50,10 +49,15 @@ vars:
     - "adminforth-key-value-adapter-ram"
     - "adminforth-login-captcha-adapter-cloudflare"
     - "adminforth-login-captcha-adapter-recaptcha"
-    - "adminforth-completion-adapter-google-gemini"
     - "adminforth-key-value-adapter-redis"
     - "adminforth-key-value-adapter-leveldb"
     - "adminforth-image-generation-adapter-nano-banana"
+    # legacy
+    - "adminforth-completion-adapter-open-ai-chat-gpt"
+
+    - "adminforth-completion-adapter-openai-responses"
+    - "adminforth-completion-adapter-antropic-messages"
+    - "adminforth-completion-adapter-google-gemini"
 
 
 tasks:
diff --git a/dev-demo/resources/adminuser.ts b/dev-demo/resources/adminuser.ts
@@ -11,7 +11,7 @@ import OpenSignupPlugin from '../../plugins/adminforth-open-signup/index.js';
 import OAuthPlugin from '../../plugins/adminforth-oauth/index.js';
 import KeyValueAdapterRam from '../../adapters/adminforth-key-value-adapter-ram/index.js';
 import AdminForthAgent from '../../plugins/adminforth-agent/index.js';
-import CompletionAdapterOpenAIChatGPT from '../../adapters/adminforth-completion-adapter-open-ai-chat-gpt/index.js';
+import CompletionAdapterOpenAIResponses from '../../adapters/adminforth-completion-adapter-openai-responses/index.js';
 
 async function allowedForSuperAdmin({ adminUser }: { adminUser: AdminUser }): Promise<boolean> {
   return adminUser.dbUser.role === 'superadmin';
@@ -202,7 +202,7 @@ export default {
       modes: [
         {
           name: 'Balanced',
-          completionAdapter: new CompletionAdapterOpenAIChatGPT({
+          completionAdapter: new CompletionAdapterOpenAIResponses({
             openAiApiKey: process.env.OPENAI_API_KEY as string,
             model: 'gpt-5.4-mini',
             extraRequestBodyParameters: {
@@ -214,7 +214,7 @@ export default {
         },
         {
           name: 'Fast',
-          completionAdapter: new CompletionAdapterOpenAIChatGPT({
+          completionAdapter: new CompletionAdapterOpenAIResponses({
             openAiApiKey: process.env.OPENAI_API_KEY as string,
             model: 'gpt-5.4-mini',
             extraRequestBodyParameters: {
@@ -226,7 +226,7 @@ export default {
         },
         {
           name: 'Smart Thinking',
-          completionAdapter: new CompletionAdapterOpenAIChatGPT({
+          completionAdapter: new CompletionAdapterOpenAIResponses({
             openAiApiKey: process.env.OPENAI_API_KEY as string,
             model: 'gpt-5.4',
             extraRequestBodyParameters: {
diff --git a/dev-demo/resources/cars_resources/carsResourseTemplate.ts b/dev-demo/resources/cars_resources/carsResourseTemplate.ts
@@ -15,7 +15,7 @@ import MarkdownPlugin from '../../../plugins/adminforth-markdown/index.js';
 import QuickFiltersPlugin from '../../../plugins/adminforth-quick-filters/index.js';
 import Many2ManyPlugin from '../../../plugins/adminforth-many2many/index.js';
 
-import CompletionAdapterOpenAIChatGPT from '../../../adapters/adminforth-completion-adapter-open-ai-chat-gpt/index.js';
+import CompletionAdapterOpenAIResponses from '../../../adapters/adminforth-completion-adapter-openai-responses/index.js';
 import CompletionAdapterGoogleGemini from '../../../adapters/adminforth-completion-adapter-google-gemini/index.js';
 import ImageGenerationAdapterOpenAI from '../../../adapters/adminforth-image-generation-adapter-openai/index.js';
 import AdminForthStorageAdapterLocalFilesystem from "../../../adapters/adminforth-storage-adapter-local/index.js";
@@ -243,7 +243,7 @@ export default function carsResourseTemplate(resourceId: string, dataSource: Car
         },
         ...(process.env.OPENAI_API_KEY ? {
           completion: {
-            adapter: new CompletionAdapterOpenAIChatGPT({
+            adapter: new CompletionAdapterOpenAIResponses({
               openAiApiKey: process.env.OPENAI_API_KEY as string,
               model: 'gpt-5-mini',
             }),
@@ -325,7 +325,7 @@ export default function carsResourseTemplate(resourceId: string, dataSource: Car
         }),
         new TextCompletePlugin({
           fieldName: 'model',
-          adapter: new CompletionAdapterOpenAIChatGPT({
+          adapter: new CompletionAdapterOpenAIResponses({
             openAiApiKey: process.env.OPENAI_API_KEY as string,
             model: 'gpt-5-nano',
             extraRequestBodyParameters: {
@@ -336,7 +336,7 @@ export default function carsResourseTemplate(resourceId: string, dataSource: Car
         new BulkAiFlowPlugin({
           actionName: 'Generate description and Price',
           askConfirmationBeforeGenerating: true,
-          textCompleteAdapter: new CompletionAdapterOpenAIChatGPT({
+          textCompleteAdapter: new CompletionAdapterOpenAIResponses({
             openAiApiKey: process.env.OPENAI_API_KEY as string,
             model: "gpt-5-mini",
             extraRequestBodyParameters: {
diff --git a/dev-demo/resources/translations.ts b/dev-demo/resources/translations.ts
@@ -1,5 +1,5 @@
 
-import CompletionAdapterOpenAIChatGPT from "../../adapters/adminforth-completion-adapter-open-ai-chat-gpt/index.js";
+import CompletionAdapterOpenAIResponses from "../../adapters/adminforth-completion-adapter-openai-responses/index.js";
 import AdminForth, { AdminForthDataTypes, AdminForthResourceInput } from "../../adminforth/index.js";
 import I18nPlugin from "../../plugins/adminforth-i18n/index.js";
 import { randomUUID } from 'crypto';
@@ -38,7 +38,7 @@ export default {
       completedFieldName: 'completedLangs',
       ...(process.env.OPENAI_API_KEY ? 
         { 
-        completeAdapter: new CompletionAdapterOpenAIChatGPT({
+        completeAdapter: new CompletionAdapterOpenAIResponses({
           openAiApiKey: process.env.OPENAI_API_KEY as string,
           model: 'gpt-5-mini',
         }),
diff --git a/live-demo/app/package.json b/live-demo/app/package.json
@@ -21,7 +21,7 @@
     "@adminforth/bulk-ai-flow": "^1.23.14",
     "@adminforth/chat-gpt": "^1.0.20",
     "@adminforth/clone-row": "^1.2.0",
-    "@adminforth/completion-adapter-open-ai-chat-gpt": "^2.0.19",
+    "@adminforth/completion-adapter-openai-responses": "^2.0.21",
     "@adminforth/email-password-reset": "^1.3.6",
     "@adminforth/foreign-inline-list": "^1.10.5",
     "@adminforth/i18n": "^1.6.7",
diff --git a/live-demo/app/pnpm-lock.yaml b/live-demo/app/pnpm-lock.yaml
diff --git a/live-demo/app/resources/apartments.ts b/live-demo/app/resources/apartments.ts
diff --git a/live-demo/app/resources/translations.ts b/live-demo/app/resources/translations.ts
diff --git a/live-demo/app/resources/users.ts b/live-demo/app/resources/users.ts
