aibo/BoosAPI
1
0
Fork 0
forked from boos/BoosAPI
Code Pull Requests Activity

feat: rewrite user journey documentation and enhance input file handling in responses

Browse Source
This commit is contained in:
cita
2026-03-09 18:25:09 +08:00
parent 3da1b93c39
commit 15d4b207cc
9 changed files with 276 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/server/transformers/openai/responses/conversion.test.ts
+42 -4
View File
@@ -393,7 +393,7 @@ describe('convertOpenAiBodyToResponsesBody', () => {
expect(result.include).toBeUndefined();
});
it('maps OpenAI file-style content blocks into Responses input_file blocks', () => {
it('maps OpenAI file-style content blocks into inline-only Responses input_file blocks', () => {
const result = convertOpenAiBodyToResponsesBody(
{
model: 'gpt-5',
@@ -425,7 +425,6 @@ describe('convertOpenAiBodyToResponsesBody', () => {
{ type: 'input_text', text: 'summarize this file' },
{
type: 'input_file',
file_id: 'file_local_123',
filename: 'report.pdf',
file_data: 'data:application/pdf;base64,JVBERi0xLjQK',
},
@@ -766,7 +765,7 @@ describe('convertResponsesBodyToOpenAiBody', () => {
});
});
it('keeps Responses input_file items when converting back to OpenAI-compatible bodies', () => {
it('keeps Responses input_file items when converting back to OpenAI-compatible bodies without conflicting file ids', () => {
const result = convertResponsesBodyToOpenAiBody(
{
model: 'gpt-5',
@@ -799,7 +798,6 @@ describe('convertResponsesBodyToOpenAiBody', () => {
{
type: 'file',
file: {
file_id: 'file_local_456',
filename: 'notes.md',
mime_type: 'text/markdown',
file_data: 'IyBoZWxsbwo=',
@@ -810,6 +808,46 @@ describe('convertResponsesBodyToOpenAiBody', () => {
]);
});
it('keeps Responses input_file file_url items when converting back to OpenAI-compatible bodies', () => {
const result = convertResponsesBodyToOpenAiBody(
{
model: 'gpt-5',
input: [
{
type: 'message',
role: 'user',
content: [
{ type: 'input_text', text: 'read this remote file' },
{
type: 'input_file',
filename: 'remote.pdf',
file_url: 'https://example.com/remote.pdf',
},
],
},
],
},
'gpt-5',
false,
);
expect(result.messages).toEqual([
{
role: 'user',
content: [
{ type: 'text', text: 'read this remote file' },
{
type: 'file',
file: {
filename: 'remote.pdf',
file_url: 'https://example.com/remote.pdf',
},
},
],
},
]);
});
it('keeps richer field parity on compatibility retry bodies when metadata is absent', () => {
const candidates = buildResponsesCompatibilityBodies({
model: 'gpt-5',
src/server/transformers/shared/inputFile.ts
+11 -4
View File
@@ -29,6 +29,7 @@ export type NormalizedInputFile = {
sourceType?: 'file' | 'input_file';
fileId?: string;
fileData?: string;
fileUrl?: string;
filename?: string;
mimeType?: string | null;
hadDataUrl?: boolean;
@@ -59,9 +60,10 @@ export function normalizeInputFileBlock(item: Record<string, unknown>): Normaliz
if (type === 'input_file') {
const fileId = asTrimmedString(item.file_id);
const fileData = asTrimmedString(item.file_data);
const fileUrl = asTrimmedString(item.file_url);
const filename = asTrimmedString(item.filename);
let mimeType = asTrimmedString(item.mime_type ?? item.mimeType) || null;
if (!fileId && !fileData) return null;
if (!fileId && !fileData && !fileUrl) return null;
const parsedDataUrl = fileData ? splitBase64DataUrl(fileData) : null;
if (parsedDataUrl) {
mimeType = mimeType || parsedDataUrl.mimeType;
@@ -70,6 +72,7 @@ export function normalizeInputFileBlock(item: Record<string, unknown>): Normaliz
sourceType: 'input_file',
fileId: fileId || undefined,
fileData: fileData || undefined,
fileUrl: fileUrl || undefined,
filename: filename || undefined,
mimeType,
hadDataUrl: /^data:[^;,]+;base64,/i.test(fileData),
@@ -80,9 +83,10 @@ export function normalizeInputFileBlock(item: Record<string, unknown>): Normaliz
const file = isRecord(item.file) ? item.file : item;
const fileId = asTrimmedString(file.file_id ?? item.file_id);
const fileData = asTrimmedString(file.file_data ?? item.file_data);
const fileUrl = asTrimmedString(file.file_url ?? item.file_url);
const filename = asTrimmedString(file.filename ?? item.filename);
let mimeType = asTrimmedString(file.mime_type ?? file.mimeType ?? item.mime_type ?? item.mimeType) || null;
if (!fileId && !fileData) return null;
if (!fileId && !fileData && !fileUrl) return null;
const parsedDataUrl = fileData ? splitBase64DataUrl(fileData) : null;
if (parsedDataUrl) {
mimeType = mimeType || parsedDataUrl.mimeType;
@@ -91,6 +95,7 @@ export function normalizeInputFileBlock(item: Record<string, unknown>): Normaliz
sourceType: 'file',
fileId: fileId || undefined,
fileData: fileData || undefined,
fileUrl: fileUrl || undefined,
filename: filename || undefined,
mimeType,
hadDataUrl: /^data:[^;,]+;base64,/i.test(fileData),
@@ -103,13 +108,14 @@ export function normalizeInputFileBlock(item: Record<string, unknown>): Normaliz
export function toResponsesInputFileBlock(file: NormalizedInputFile): Record<string, unknown> {
const parsedDataUrl = file.fileData ? splitBase64DataUrl(file.fileData) : null;
const block: Record<string, unknown> = { type: 'input_file' };
if (file.fileId) block.file_id = file.fileId;
if (file.fileData) {
block.file_data = ensureBase64DataUrl(
file.fileData,
parsedDataUrl?.mimeType || inferInputFileMimeType(file),
);
}
if (file.fileUrl && !block.file_data) block.file_url = file.fileUrl;
if (file.fileId && !block.file_data && !block.file_url) block.file_id = file.fileId;
if (file.filename) block.filename = file.filename;
return block;
}
@@ -117,8 +123,9 @@ export function toResponsesInputFileBlock(file: NormalizedInputFile): Record<str
export function toOpenAiChatFileBlock(file: NormalizedInputFile): Record<string, unknown> {
const parsedDataUrl = file.fileData ? splitBase64DataUrl(file.fileData) : null;
const payload: Record<string, unknown> = {};
if (file.fileId) payload.file_id = file.fileId;
if (file.fileData) payload.file_data = parsedDataUrl?.data || file.fileData;
else if (file.fileUrl) payload.file_url = file.fileUrl;
else if (file.fileId) payload.file_id = file.fileId;
if (file.filename) payload.filename = file.filename;
if (file.mimeType) payload.mime_type = file.mimeType;
else if (parsedDataUrl?.mimeType) payload.mime_type = parsedDataUrl.mimeType;