ima2-gen 1.1.21 → 1.1.23

package/lib/promptBuilder/constants.ts

@@ -1,9 +0,0 @@
-export const VALID_PROMPT_BUILDER_MODELS = new Set(["gpt-5.5", "gpt-5.4", "gpt-5.4-mini"]);
-export const DEFAULT_PROMPT_BUILDER_MODEL = "gpt-5.5";
-export const MAX_MESSAGES = 24;
-export const MAX_MESSAGE_CHARS = 16_000;
-export const MAX_ATTACHMENTS = 6;
-export const MAX_TEXT_ATTACHMENT_CHARS = 20_000;
-export const MAX_ATTACHMENT_NAME_CHARS = 160;
-export const MAX_ATTACHMENT_MIME_CHARS = 120;
-export const PROMPT_BUILDER_RESPONSE_MAX_OUTPUT_TOKENS = 2400;

package/lib/promptBuilder/context.ts

@@ -1,36 +0,0 @@
-import type { PromptBuilderContext } from "./types.js";
-
-export function contextText(context: PromptBuilderContext | undefined): string {
-  const lines: string[] = [];
-  const currentPrompt =
-    typeof context?.currentPrompt === "string" ? context.currentPrompt.trim() : "";
-  if (currentPrompt) lines.push(`Current main prompt:\n${currentPrompt}`);
-
-  const blocks = Array.isArray(context?.insertedPrompts) ? context.insertedPrompts : [];
-  if (blocks.length > 0) {
-    lines.push(
-      `Inserted prompt blocks:\n${blocks
-        .map((block, index) => {
-          const name =
-            typeof block.name === "string" && block.name.trim()
-              ? block.name.trim()
-              : `Block ${index + 1}`;
-          const text = typeof block.text === "string" ? block.text.trim() : "";
-          return `- ${name}: ${text}`;
-        })
-        .join("\n")}`,
-    );
-  }
-
-  if (context?.settings && typeof context.settings === "object") {
-    lines.push(`Generation settings:\n${JSON.stringify(context.settings)}`);
-  }
-
-  const resultPrompt =
-    typeof context?.currentResultPrompt === "string"
-      ? context.currentResultPrompt.trim()
-      : "";
-  if (resultPrompt) lines.push(`Current result prompt:\n${resultPrompt}`);
-
-  return lines.join("\n\n");
-}

package/lib/promptBuilder/errors.ts

@@ -1,12 +0,0 @@
-import type { PromptBuilderError } from "./types.js";
-
-export function promptBuilderError(
-  message: string,
-  code: string,
-  status = 400,
-): PromptBuilderError {
-  const err = new Error(message) as PromptBuilderError;
-  err.code = code;
-  err.status = status;
-  return err;
-}

package/lib/promptBuilder/requestSchema.ts

@@ -1,56 +0,0 @@
-import {
-  VALID_PROMPT_BUILDER_MODELS,
-  DEFAULT_PROMPT_BUILDER_MODEL,
-  MAX_MESSAGES,
-  MAX_MESSAGE_CHARS,
-} from "./constants.js";
-import { promptBuilderError } from "./errors.js";
-import { normalizeAttachments } from "./attachments.js";
-import type { PromptBuilderMessage } from "./types.js";
-
-export function normalizeModel(raw: unknown): string {
-  if (typeof raw !== "string" || raw.trim().length === 0) return DEFAULT_PROMPT_BUILDER_MODEL;
-  if (!VALID_PROMPT_BUILDER_MODELS.has(raw)) {
-    throw promptBuilderError(
-      "model must be one of: gpt-5.5, gpt-5.4, gpt-5.4-mini",
-      "PROMPT_BUILDER_BAD_MODEL",
-    );
-  }
-  return raw;
-}
-
-export function normalizeMessages(raw: unknown): PromptBuilderMessage[] {
-  if (!Array.isArray(raw)) {
-    throw promptBuilderError("messages must be an array", "PROMPT_BUILDER_BAD_MESSAGES");
-  }
-  const messages = raw.slice(-MAX_MESSAGES).map((message): PromptBuilderMessage => {
-    if (!message || typeof message !== "object") {
-      throw promptBuilderError("each message must be an object", "PROMPT_BUILDER_BAD_MESSAGES");
-    }
-    const item = message as { role?: unknown; content?: unknown; attachments?: unknown };
-    const role = item.role === "assistant" ? "assistant" : item.role === "user" ? "user" : null;
-    if (!role) {
-      throw promptBuilderError(
-        "message role must be user or assistant",
-        "PROMPT_BUILDER_BAD_MESSAGES",
-      );
-    }
-    const content = typeof item.content === "string" ? item.content.trim() : "";
-    if (!content && role === "user") {
-      throw promptBuilderError("message content is required", "PROMPT_BUILDER_EMPTY_MESSAGE");
-    }
-    return {
-      role,
-      content: content.slice(0, MAX_MESSAGE_CHARS),
-      attachments: normalizeAttachments(item.attachments),
-    };
-  });
-  const last = messages.at(-1);
-  if (!last || last.role !== "user" || !last.content.trim()) {
-    throw promptBuilderError(
-      "last message must be a non-empty user message",
-      "PROMPT_BUILDER_EMPTY_MESSAGE",
-    );
-  }
-  return messages;
-}

package/lib/promptBuilder/responseParser.ts

@@ -1,219 +0,0 @@
-import { promptBuilderError } from "./errors.js";
-import type {
-  PromptBuilderError,
-  ResponseShapeSummary,
-  ChatCompletionBody,
-  ResponsesBody,
-  ResponsesReadResult,
-} from "./types.js";
-
-function safeUpstreamString(value: unknown): string | undefined {
-  return typeof value === "string" && value.trim()
-    ? value.trim().slice(0, 160)
-    : undefined;
-}
-
-export function parseUpstreamError(text: string): Pick<
-  PromptBuilderError,
-  "upstreamCode" | "upstreamType" | "upstreamParam"
-> {
-  try {
-    const body = JSON.parse(text) as { error?: Record<string, unknown> };
-    const error =
-      body && typeof body.error === "object" ? body.error : undefined;
-    return {
-      upstreamCode: safeUpstreamString(error?.code),
-      upstreamType: safeUpstreamString(error?.type),
-      upstreamParam: safeUpstreamString(error?.param),
-    };
-  } catch {
-    return {};
-  }
-}
-
-export function responseSummary(body: unknown): ResponseShapeSummary {
-  if (!body || typeof body !== "object") {
-    return {
-      responseBodyKeys: "",
-      responseStatus: undefined,
-      responseErrorCode: undefined,
-      responseErrorType: undefined,
-      responseErrorParam: undefined,
-      responseIncompleteReason: undefined,
-      responseOutputTypes: "",
-      responseContentTypes: "",
-      responseOutputCount: 0,
-      responseContentCount: 0,
-    };
-  }
-  const record = body as Record<string, unknown>;
-  const output = Array.isArray(record.output) ? record.output : [];
-  const error =
-    record.error && typeof record.error === "object"
-      ? (record.error as Record<string, unknown>)
-      : undefined;
-  const incomplete =
-    record.incomplete_details && typeof record.incomplete_details === "object"
-      ? (record.incomplete_details as Record<string, unknown>)
-      : undefined;
-  const contentItems = output.flatMap((item) => {
-    if (!item || typeof item !== "object") return [];
-    const content = (item as { content?: unknown }).content;
-    return Array.isArray(content) ? content : [];
-  });
-  const outputTypes = output
-    .map((item) =>
-      item && typeof item === "object"
-        ? (item as { type?: unknown }).type
-        : undefined,
-    )
-    .filter((t): t is string => typeof t === "string" && t.length > 0);
-  const contentTypes = contentItems
-    .map((item) =>
-      item && typeof item === "object"
-        ? (item as { type?: unknown }).type
-        : undefined,
-    )
-    .filter((t): t is string => typeof t === "string" && t.length > 0);
-  return {
-    responseBodyKeys: Object.keys(record).slice(0, 12).join(","),
-    responseStatus: safeUpstreamString(record.status),
-    responseErrorCode: safeUpstreamString(error?.code),
-    responseErrorType: safeUpstreamString(error?.type),
-    responseErrorParam: safeUpstreamString(error?.param),
-    responseIncompleteReason: safeUpstreamString(incomplete?.reason),
-    responseOutputTypes: Array.from(new Set(outputTypes))
-      .slice(0, 12)
-      .join(","),
-    responseContentTypes: Array.from(new Set(contentTypes))
-      .slice(0, 12)
-      .join(","),
-    responseOutputCount: output.length,
-    responseContentCount: contentItems.length,
-  };
-}
-
-function extractSseData(block: string): string {
-  return block
-    .split("\n")
-    .filter((line) => line.startsWith("data:"))
-    .map((line) => line.slice(5).trimStart())
-    .join("\n");
-}
-
-function parseSseJson(block: string): Record<string, unknown> | null {
-  const data = extractSseData(block);
-  if (!data || data === "[DONE]") return null;
-  try {
-    const parsed = JSON.parse(data) as unknown;
-    return parsed && typeof parsed === "object" && !Array.isArray(parsed)
-      ? (parsed as Record<string, unknown>)
-      : null;
-  } catch {
-    return null;
-  }
-}
-
-export function extractChatText(body: ChatCompletionBody): string {
-  return (
-    body.choices?.find(
-      (c) => typeof c.message?.content === "string" && c.message.content.trim(),
-    )?.message?.content ?? ""
-  );
-}
-
-export function extractResponsesText(body: ResponsesBody): string {
-  if (typeof body.output_text === "string" && body.output_text.trim())
-    return body.output_text;
-  for (const item of body.output ?? []) {
-    for (const content of item.content ?? []) {
-      if (typeof content.text === "string" && content.text.trim())
-        return content.text;
-      if (
-        content.text &&
-        typeof content.text === "object" &&
-        typeof content.text.value === "string" &&
-        content.text.value.trim()
-      )
-        return content.text.value;
-      if (typeof content.value === "string" && content.value.trim())
-        return content.value;
-      if (typeof content.refusal === "string" && content.refusal.trim())
-        return content.refusal;
-    }
-  }
-  return "";
-}
-
-export async function readResponsesStream(
-  res: Response,
-): Promise<ResponsesReadResult> {
-  const reader = res.body?.getReader();
-  const decoder = new TextDecoder();
-  const deltas: string[] = [];
-  let buffer = "";
-  let usage: Record<string, unknown> | null = null;
-  let summary = responseSummary(null);
-  if (!reader) return { content: "", usage, summary };
-  while (true) {
-    const { done, value } = await reader.read();
-    if (done) break;
-    buffer += decoder.decode(value, { stream: true });
-    let boundary = buffer.indexOf("\n\n");
-    while (boundary !== -1) {
-      const block = buffer.slice(0, boundary);
-      buffer = buffer.slice(boundary + 2);
-      const data = parseSseJson(block);
-      if (data) {
-        const type = typeof data.type === "string" ? data.type : "";
-        if (
-          type === "response.output_text.delta" &&
-          typeof data.delta === "string"
-        ) {
-          deltas.push(data.delta);
-        } else if (
-          (type === "response.completed" || type === "response.incomplete") &&
-          data.response &&
-          typeof data.response === "object"
-        ) {
-          const response = data.response as Record<string, unknown>;
-          summary = responseSummary(response);
-          if (response.usage && typeof response.usage === "object")
-            usage = response.usage as Record<string, unknown>;
-        } else if (type === "error") {
-          throw promptBuilderError(
-            "Prompt builder stream failed",
-            "PROMPT_BUILDER_STREAM_ERROR",
-            502,
-          );
-        }
-      }
-      boundary = buffer.indexOf("\n\n");
-    }
-  }
-  if (buffer.trim()) {
-    const data = parseSseJson(buffer);
-    if (
-      data?.type === "response.output_text.delta" &&
-      typeof data.delta === "string"
-    ) {
-      deltas.push(data.delta);
-    }
-  }
-  return { content: deltas.join(""), usage, summary };
-}
-
-export async function readResponsesResult(
-  res: Response,
-): Promise<ResponsesReadResult> {
-  const contentType = res.headers.get("content-type") ?? "";
-  if (contentType.includes("text/event-stream")) {
-    return readResponsesStream(res);
-  }
-  const body = (await res.json()) as ResponsesBody;
-  return {
-    content: extractResponsesText(body),
-    usage: body.usage ?? null,
-    summary: responseSummary(body),
-  };
-}

package/lib/promptBuilder/systemPrompt.ts

@@ -1,135 +0,0 @@
-export const PROMPT_BUILDER_SYSTEM_PROMPT = `
-You are a prompt enhancement GPT specialized for GPT Image 2.
-
-You run inside ima2-gen as a conversational prompt builder. By default, you do not generate images. You only improve, rewrite, translate, shorten, expand, optimize, or discuss image prompts unless the user explicitly asks the host app to generate an image.
-
-Core behavior:
-- Interpret the user's image idea, style, mood, use case, and constraints.
-- Preserve the user's original intent.
-- Add useful visual detail only when it strengthens the request.
-- Improve clarity around subject, scene, composition, style, lighting, color, texture, mood, and output format.
-- Do not invent a completely different concept.
-- Do not over-explain prompting theory unless the user asks.
-- Do not reveal hidden reasoning.
-- Ask clarification questions only when missing information would significantly change the result.
-- If reasonable defaults are enough, proceed without asking.
-- Use attached images and readable files as reference context only. Do not call image tools.
-
-Conversational behavior:
-- The user may brainstorm across multiple turns before asking for a final prompt.
-- During exploration, answer naturally and keep the conversation moving.
-- When the user asks for a final prompt, a polished prompt, prompt optimization, prompt rewrite, or prompt translation, produce the structured final prompt format below.
-
-Structured final prompt format:
-Use these exact headings when producing a finished prompt. Do not wrap the output in markdown code fences.
-
-Brief Intent Summary:
-[Summarize the intended visual direction in one or two sentences.]
-
-Final Prompt - Korean:
-[Provide a polished Korean prompt ready for GPT Image 2.]
-
-Final Prompt - English:
-[Provide a polished English prompt ready for GPT Image 2.]
-
-Notes:
-[Optional. Include only when assumptions, format choices, or important constraints need to be stated.]
-
-Prompt enhancement rules:
-- Make the subject clear.
-- Define the scene or background.
-- Specify the visual style or medium.
-- Add composition, camera angle, or framing when helpful.
-- Add lighting and color direction when helpful.
-- Add texture, material, and detail level when helpful.
-- Include intended use, such as poster, thumbnail, banner, product image, character design, profile image, concept art, or editorial image, when relevant.
-- Include aspect ratio or format when the user specifies it or when it can be reasonably inferred.
-- Keep the prompt visually actionable rather than abstract.
-- If the user mentions something to avoid, incorporate that constraint naturally into the final prompt text instead of creating a separate negative prompt section.
-
-Positive-only prompting rules:
-The final prompt must be written as a positive description of the desired image, not as a list of things to avoid.
-
-When the user describes something they do not want, treat it as an internal constraint only. Do not repeat the unwanted concept in the final Korean or English prompt unless it is absolutely necessary for user-facing clarification.
-
-Convert negative instructions into positive target attributes:
-- "not elderly" -> "young adult"
-- "not messy" -> "clean, organized composition"
-- "not scary" -> "calm, approachable mood"
-- "not cartoonish" -> "realistic, natural proportions and textures"
-- "not too colorful" -> "restrained, muted color palette"
-- "no clutter" -> "minimal background with clear focal hierarchy"
-- "do not change the face" -> "preserve the original facial identity, expression, and proportions"
-- "do not change the product shape" -> "preserve the original product silhouette, proportions, and key design features"
-
-Avoid these patterns in the final Korean and English prompt text:
-- "not ..."
-- "no ..."
-- "without ..."
-- "avoid ..."
-- "do not ..."
-- "instead of ..."
-- "rather than ..."
-- "unlike ..."
-
-Before finalizing, perform a positive-only rewrite pass:
-1. Identify any unwanted concept mentioned by the user.
-2. Replace it with the desired visual target.
-3. Remove the unwanted concept from the final prompt.
-4. Remove negation phrasing from both Korean and English prompts.
-5. Ensure the final prompt describes only what should appear in the image.
-
-When the user gives a vague style word, translate it into concrete visual language:
-- Minimal: clean composition, negative space, simple forms, restrained palette.
-- Cinematic: filmic framing, dramatic lighting, atmospheric depth, controlled contrast.
-- Luxury: refined materials, elegant lighting, polished surfaces, restrained color palette.
-- Cute: rounded shapes, friendly expression, soft proportions, bright or pastel colors.
-- Dreamy: soft focus, glowing light, haze, delicate details, ethereal mood.
-- Vintage: film grain, faded tones, retro palette, nostalgic texture.
-- Futuristic: sleek forms, advanced materials, luminous accents, clean technology-inspired design.
-- Cyberpunk: neon lighting, rainy urban atmosphere, reflective surfaces, dark high-contrast palette.
-- Photorealistic: realistic lighting, natural textures, camera-based composition, believable details.
-- 3D: dimensional form, clear materials, shadows, polished rendering.
-- Illustration: stylized shapes, linework or painterly treatment, controlled color design.
-
-For image editing prompts:
-- Clearly state what should be preserved.
-- Clearly state what should be changed.
-- Explain how the new elements should blend with the original image.
-- Mention consistency of lighting, perspective, edges, identity, and material when relevant.
-- Provide both Korean and English edit prompts.
-- If there are unwanted changes to prevent, express them as preservation constraints inside the prompt, such as "keep the original face, pose, clothing, and proportions unchanged."
-
-For reference images:
-- Identify whether the image is a style reference, subject reference, composition reference, product reference, color reference, mood reference, or edit target.
-- Preserve the important traits requested by the user.
-- Do not assume the reference image should control every detail unless the user says so.
-
-For text inside images:
-- Preserve the exact wording provided by the user.
-- Put the exact text in quotation marks.
-- Specify placement, typography, hierarchy, and legibility when relevant.
-- Do not translate visible text unless the user asks for translation.
-
-For variations:
-- Provide clearly separated versions.
-- Each version must include both Korean and English prompts.
-- Vary only the requested axis, such as style, mood, color palette, composition, camera angle, background, medium, or lighting.
-- Do not generate images unless explicitly asked.
-
-Safety and style limits:
-- Do not create prompts that violate safety policy.
-- Do not directly imitate a living artist's distinctive current style.
-- When a living artist style is requested, replace it with broader visual characteristics such as medium, color, lighting, era, composition, texture, or mood.
-- Avoid prompts that enable deception, impersonation, or harmful misuse.
-- For real people, avoid defamatory, sexualized, misleading, or dignity-violating framing.
-
-Before finalizing, check:
-- Does the prompt preserve the user's original idea?
-- Are both Korean and English versions included?
-- Are the two versions semantically aligned?
-- Is the prompt specific enough for image generation?
-- Are constraints expressed inside the prompt text rather than as a separate negative prompt?
-- Are any assumptions brief and reasonable?
-- Is the output ready to copy and use?
-`.trim();

package/lib/promptBuilder/transport.ts

@@ -1,94 +0,0 @@
-import { attachmentText, hasImageAttachments } from "./attachments.js";
-import { PROMPT_BUILDER_RESPONSE_MAX_OUTPUT_TOKENS } from "./constants.js";
-import { PROMPT_BUILDER_SYSTEM_PROMPT } from "./systemPrompt.js";
-import { contextText } from "./context.js";
-import type {
-  PromptBuilderMessage,
-  PromptBuilderContext,
-  ChatContentPart,
-  ResponsesContentPart,
-} from "./types.js";
-
-function toChatContent(
-  message: PromptBuilderMessage,
-): string | ChatContentPart[] {
-  const text = [message.content, attachmentText(message.attachments)]
-    .filter(Boolean)
-    .join("\n\n");
-  const imageParts = (message.attachments ?? [])
-    .filter((a) => a.kind === "image" && a.dataUrl)
-    .map(
-      (a): ChatContentPart => ({
-        type: "image_url",
-        image_url: { url: a.dataUrl as string },
-      }),
-    );
-  if (imageParts.length === 0) return text;
-  return [{ type: "text", text }, ...imageParts];
-}
-
-function toResponsesContent(
-  message: PromptBuilderMessage,
-): string | ResponsesContentPart[] {
-  const text = [message.content, attachmentText(message.attachments)]
-    .filter(Boolean)
-    .join("\n\n");
-  const imageParts = (message.attachments ?? [])
-    .filter((a) => a.kind === "image" && a.dataUrl)
-    .map(
-      (a): ResponsesContentPart => ({
-        type: "input_image",
-        image_url: a.dataUrl as string,
-      }),
-    );
-  if (imageParts.length === 0) return text;
-  return [{ type: "input_text", text }, ...imageParts];
-}
-
-export type TransportPayload = {
-  endpoint: "chat" | "responses";
-  body: Record<string, unknown>;
-};
-
-export function buildTransportPayload(
-  model: string,
-  messages: PromptBuilderMessage[],
-  context: PromptBuilderContext | undefined,
-): TransportPayload {
-  const currentContextText = contextText(context);
-  const systemText = [
-    PROMPT_BUILDER_SYSTEM_PROMPT,
-    currentContextText ? `Current ima2-gen context:\n${currentContextText}` : "",
-  ]
-    .filter(Boolean)
-    .join("\n\n");
-
-  const useResponses = hasImageAttachments(messages);
-  const endpoint = useResponses ? "responses" : "chat";
-
-  const body = useResponses
-    ? {
-        model,
-        instructions: systemText,
-        input: messages.map((m) => ({
-          role: m.role,
-          content: toResponsesContent(m),
-        })),
-        stream: true,
-        max_output_tokens: PROMPT_BUILDER_RESPONSE_MAX_OUTPUT_TOKENS,
-      }
-    : {
-        model,
-        messages: [
-          { role: "system", content: systemText },
-          ...messages.map((m) => ({
-            role: m.role,
-            content: toChatContent(m),
-          })),
-        ],
-        stream: false,
-        reasoning_effort: "low",
-      };
-
-  return { endpoint, body };
-}

package/lib/promptBuilder/types.ts

@@ -1,109 +0,0 @@
-export type PromptBuilderRole = "user" | "assistant";
-
-export type PromptBuilderAttachment = {
-  kind: "image" | "text" | "file";
-  name: string;
-  mimeType: string;
-  size: number;
-  dataUrl?: string;
-  text?: string;
-};
-
-export type PromptBuilderMessage = {
-  role: PromptBuilderRole;
-  content: string;
-  attachments?: PromptBuilderAttachment[];
-};
-
-export type PromptBuilderContext = {
-  currentPrompt?: string;
-  insertedPrompts?: Array<{ name?: string; text?: string }>;
-  settings?: Record<string, unknown>;
-  currentResultPrompt?: string | null;
-};
-
-export type PromptBuilderRequest = {
-  model?: unknown;
-  messages?: unknown;
-  context?: PromptBuilderContext;
-};
-
-export type PromptBuilderError = Error & {
-  status?: number;
-  code?: string;
-  upstreamStatus?: number;
-  upstreamBodyChars?: number;
-  upstreamEndpoint?: "chat" | "responses";
-  upstreamCode?: string;
-  upstreamType?: string;
-  upstreamParam?: string;
-  responseBodyKeys?: string;
-  responseStatus?: string;
-  responseErrorCode?: string;
-  responseErrorType?: string;
-  responseErrorParam?: string;
-  responseIncompleteReason?: string;
-  responseOutputTypes?: string;
-  responseContentTypes?: string;
-  responseOutputCount?: number;
-  responseContentCount?: number;
-};
-
-export type ResponseShapeSummary = Pick<
-  PromptBuilderError,
-  | "responseBodyKeys"
-  | "responseStatus"
-  | "responseErrorCode"
-  | "responseErrorType"
-  | "responseErrorParam"
-  | "responseIncompleteReason"
-  | "responseOutputTypes"
-  | "responseContentTypes"
-  | "responseOutputCount"
-  | "responseContentCount"
->;
-
-export type ChatCompletionBody = {
-  choices?: Array<{
-    message?: {
-      role?: string;
-      content?: string | null;
-    };
-  }>;
-  usage?: Record<string, unknown>;
-};
-
-export type ResponsesBody = {
-  output_text?: string;
-  output?: Array<{
-    type?: string;
-    content?: Array<{
-      type?: string;
-      text?: string | { value?: string };
-      value?: string;
-      refusal?: string;
-    }>;
-  }>;
-  usage?: Record<string, unknown>;
-};
-
-export type ResponsesReadResult = {
-  content: string;
-  usage: Record<string, unknown> | null;
-  summary: ResponseShapeSummary;
-};
-
-export type ChatContentPart =
-  | { type: "text"; text: string }
-  | { type: "image_url"; image_url: { url: string } };
-
-export type ResponsesContentPart =
-  | { type: "input_text"; text: string }
-  | { type: "input_image"; image_url: string };
-
-export type PromptBuilderChatResult = {
-  provider: "oauth";
-  model: string;
-  message: { role: "assistant"; content: string };
-  usage: Record<string, unknown> | null;
-};