@adminforth/completion-adapter-openai-responses 1.0.0

package/.woodpecker/buildRelease.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+
+pnpm run build 2>&1 | tee build.log
+build_status=${PIPESTATUS[0]}
+
+if [ $build_status -ne 0 ]; then
+  echo "Build failed. Exiting with status code $build_status"
+  exit $build_status
+fi

package/.woodpecker/buildSlackNotify.sh

@@ -0,0 +1,44 @@
+#!/bin/sh
+
+set -x
+
+COMMIT_SHORT_SHA=$(echo $CI_COMMIT_SHA | cut -c1-8)
+
+STATUS=${1}
+
+if [ "$STATUS" = "success" ]; then
+  MESSAGE="Did a build without issues on \`$CI_REPO_NAME/$CI_COMMIT_BRANCH\`. Commit: _${CI_COMMIT_MESSAGE}_ (<$CI_COMMIT_URL|$COMMIT_SHORT_SHA>)"
+
+  curl  -s -X POST -H "Content-Type: application/json" -d '{
+    "username": "'"$CI_COMMIT_AUTHOR"'",
+    "icon_url": "'"$CI_COMMIT_AUTHOR_AVATAR"'",
+    "attachments": [
+      {
+          "mrkdwn_in": ["text", "pretext"],
+          "color": "#36a64f",
+          "text": "'"$MESSAGE"'"
+      }
+    ]
+  }' "$DEVELOPERS_SLACK_WEBHOOK"
+  exit 0
+fi
+export BUILD_LOG=$(cat ./build.log)
+
+BUILD_LOG=$(echo $BUILD_LOG | sed 's/"/\\"/g')
+
+MESSAGE="Broke \`$CI_REPO_NAME/$CI_COMMIT_BRANCH\` with commit _${CI_COMMIT_MESSAGE}_ (<$CI_COMMIT_URL|$COMMIT_SHORT_SHA>)"
+CODE_BLOCK="\`\`\`$BUILD_LOG\n\`\`\`"
+
+echo "Sending slack message to developers $MESSAGE"
+curl -sS -X POST -H "Content-Type: application/json" -d '{
+  "username": "'"$CI_COMMIT_AUTHOR"'",
+  "icon_url": "'"$CI_COMMIT_AUTHOR_AVATAR"'",
+  "attachments": [
+    {
+        "mrkdwn_in": ["text", "pretext"],
+        "color": "#8A1C12",
+        "text": "'"$CODE_BLOCK"'",
+        "pretext": "'"$MESSAGE"'"
+    }
+  ]
+}' "$DEVELOPERS_SLACK_WEBHOOK" 2>&1

package/.woodpecker/release.yml

@@ -0,0 +1,56 @@
+clone:
+  git:
+    image: woodpeckerci/plugin-git
+    settings:
+      partial: false
+      depth: 5
+
+steps:
+  init-secrets:
+    when:
+      - event: push
+    image: infisical/cli
+    environment:
+      INFISICAL_TOKEN:
+        from_secret: VAULT_TOKEN
+    commands:
+      - infisical export --domain https://vault.devforth.io/api --format=dotenv-export --env="prod" > /woodpecker/deploy.vault.env
+
+  build:
+    image: devforth/node20-pnpm:latest
+    when:
+      - event: push
+    commands:
+      - . /woodpecker/deploy.vault.env
+      - pnpm install
+      - /bin/bash ./.woodpecker/buildRelease.sh
+      - npm audit signatures
+
+  release:
+    image: devforth/node20-pnpm:latest
+    when:
+      - event:
+          - push
+        branch:
+          - main
+    commands:
+      - . /woodpecker/deploy.vault.env
+      - pnpm exec semantic-release
+
+  slack-on-failure:
+    image: curlimages/curl
+    when:
+      - event: push
+        status: [failure]
+    commands:
+      - . /woodpecker/deploy.vault.env
+      - /bin/sh ./.woodpecker/buildSlackNotify.sh failure
+
+  slack-on-success:
+    image: curlimages/curl
+    when:
+      - event: push
+        status: [success]
+    commands:
+      - . /woodpecker/deploy.vault.env
+      - /bin/sh ./.woodpecker/buildSlackNotify.sh success

package/Changelog.md

@@ -0,0 +1,6 @@
+## [2.0.19] - 2026-04-23
+
+### Added
+
+- Added the OpenAI Responses completion adapter package.
+- Added compatibility guidance for migrating from `@adminforth/completion-adapter-open-ai-chat-gpt`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Devforth.io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,47 @@
+# @adminforth/completion-adapter-openai-responses
+
+AdminForth completion adapter for the OpenAI Responses API.
+
+This package is the fully compatible successor to `@adminforth/completion-adapter-open-ai-chat-gpt`.
+
+## Installation
+
+```bash
+pnpm i @adminforth/completion-adapter-openai-responses
+```
+
+## Usage
+
+```ts
+import CompletionAdapterOpenAIResponses from "@adminforth/completion-adapter-openai-responses";
+
+const adapter = new CompletionAdapterOpenAIResponses({
+	openAiApiKey: process.env.OPENAI_API_KEY as string,
+	model: "gpt-5-nano",
+	extraRequestBodyParameters: {
+		temperature: 0.7,
+	},
+});
+```
+
+OpenAI-compatible providers can be used by overriding the base URL:
+
+```ts
+const adapter = new CompletionAdapterOpenAIResponses({
+	openAiApiKey: process.env.OVH_AI_ENDPOINTS_ACCESS_TOKEN as string,
+	baseUrl: "https://oai.endpoints.kepler.ai.cloud.ovh.net/v1",
+	model: "gpt-oss-20b",
+	extraRequestBodyParameters: {
+		store: false,
+	},
+});
+```
+
+The adapter supports:
+
+- regular text completion
+- `json_schema` structured output
+- reasoning effort control
+- tool calls
+- streaming output chunks
+- streaming reasoning chunks

package/build.log

@@ -0,0 +1,4 @@
+
+> @adminforth/completion-adapter-openai-responses@2.0.27 build /woodpecker/src/github.com/devforth/adminforth-completion-adapter-openai-responses
+> tsc
+

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+import type { AdapterOptions } from "./types.js";
+import type { CompletionAdapter, CompletionStreamEvent, CompletionTool } from "adminforth";
+import { ChatOpenAI } from "@langchain/openai";
+export type { AdapterOptions } from "./types.js";
+type StreamChunkCallback = (chunk: string, event?: CompletionStreamEvent) => void | Promise<void>;
+type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
+type AgentModelPurpose = "primary" | "summary";
+type CompletionRequestInput = {
+    content: string;
+    maxTokens?: number;
+    outputSchema?: any;
+    reasoningEffort?: ReasoningEffort;
+    tools?: CompletionTool[];
+    onChunk?: StreamChunkCallback;
+    signal?: AbortSignal;
+};
+type UsedTokens = {
+    input_uncached: number;
+    input_cached: number;
+    output: number;
+};
+type CompletionResult = {
+    content?: string;
+    finishReason?: string;
+    error?: string;
+    used_tokens?: UsedTokens;
+};
+export default class CompletionAdapterOpenAIResponses implements CompletionAdapter {
+    options: AdapterOptions;
+    private encoding;
+    private activeAbortController;
+    constructor(options: AdapterOptions);
+    validate(): void;
+    measureTokensCount(content: string): number;
+    abort(): void;
+    isGenerationInProgress(): boolean;
+    private getConfiguredBaseUrl;
+    private shouldUseComplitionApi;
+    private shouldDumpRawRequest;
+    private getClientConfiguration;
+    private createResponsesDebugFetch;
+    private getFetchUrl;
+    private isResponsesUrl;
+    private dumpRawRequest;
+    private getResponsesUrl;
+    getLangChainAgentSpec(params: {
+        maxTokens: number;
+        purpose: AgentModelPurpose;
+    }): {
+        model: ChatOpenAI<import("@langchain/openai").ChatOpenAICallOptions>;
+        middleware: import("langchain").AgentMiddleware<undefined, undefined, unknown, readonly (import("@langchain/core/tools").ClientTool | import("@langchain/core/tools").ServerTool)[]>[];
+    };
+    complete: (requestOrContent: CompletionRequestInput | string, maxTokens?: number, outputSchema?: any, reasoningEffort?: ReasoningEffort, toolsOrOnChunk?: CompletionTool[] | StreamChunkCallback, onChunk?: StreamChunkCallback) => Promise<CompletionResult>;
+}