@particle-academy/prism 0.0.0

package/dist/providers/openai/maps/message-map.js

@@ -0,0 +1,128 @@
+import { canonicalJson, isJsonObject } from '../../../json.js';
+import { PrismError } from '../../../errors.js';
+import { mapDocument, mapImage } from './media-map.js';
+/**
+ * Map messages onto the Responses API's flat `input` array.
+ *
+ * Three things about this mapping are easy to get subtly wrong:
+ *
+ *   1. System prompts are PREPENDED to the message list rather than carried in
+ *      a field of their own, and a system message maps to a BARE STRING content
+ *      while a user message maps to a parts ARRAY. Two roles, two shapes, one
+ *      payload.
+ *   2. An assistant message's tool calls do not stay attached to it. Each one
+ *      becomes its own top-level `function_call` item whose `arguments` is a
+ *      JSON STRING — a JSON document nested inside a JSON document.
+ *   3. A tool result is keyed by the RESULT id, not by the id of the call that
+ *      produced it.
+ *
+ * @throws PrismError code `unknown_message_type`
+ */
+export function mapMessages(messages, systemPrompts = []) {
+    const items = [];
+    for (const message of [...systemPrompts, ...messages]) {
+        switch (message.type) {
+            case 'system':
+                items.push({ role: 'system', content: message.content });
+                break;
+            case 'user':
+                items.push({
+                    role: 'user',
+                    content: [
+                        { type: 'input_text', text: message.text() },
+                        ...message.images().map(mapImage),
+                        ...message.documents().map(mapDocument),
+                    ],
+                    // Spread at ITEM level: siblings of `role` and `content`, not nested.
+                    ...message.additionalAttributes,
+                });
+                break;
+            case 'assistant':
+                mapAssistantMessage(message, items);
+                break;
+            case 'tool_result':
+                mapToolResultMessage(message, items);
+                break;
+            default:
+                throw PrismError.unknownMessageType(describeMessage(message));
+        }
+    }
+    return items;
+}
+function mapAssistantMessage(message, items) {
+    if (message.toolCalls.length > 0) {
+        for (const [reasoningId, toolCalls] of groupByReasoningId(message.toolCalls)) {
+            const first = toolCalls[0];
+            if (reasoningId !== '' && first !== undefined) {
+                items.push({
+                    type: 'reasoning',
+                    id: first.reasoningId,
+                    summary: first.reasoningSummary,
+                });
+            }
+            for (const toolCall of toolCalls) {
+                items.push({
+                    id: toolCall.id,
+                    call_id: toolCall.resultId,
+                    type: 'function_call',
+                    name: toolCall.name,
+                    arguments: canonicalJson(toolCall.parsedArguments()),
+                });
+            }
+        }
+    }
+    // An assistant turn that carried only tool calls contributes NO assistant
+    // item: an empty `output_text` part is rejected by the API.
+    if (message.content !== '') {
+        items.push({
+            role: 'assistant',
+            content: [{ type: 'output_text', text: message.content }],
+        });
+    }
+}
+function mapToolResultMessage(message, items) {
+    for (const toolResult of message.toolResults) {
+        items.push({
+            type: 'function_call_output',
+            call_id: toolResult.toolCallResultId,
+            output: stringifyToolOutput(toolResult.result),
+        });
+    }
+}
+/** Calls that share a reasoning id travel together, behind one reasoning item. */
+function groupByReasoningId(toolCalls) {
+    const groups = new Map();
+    for (const toolCall of toolCalls) {
+        const key = toolCall.reasoningId ?? '';
+        const group = groups.get(key);
+        if (group === undefined) {
+            groups.set(key, [toolCall]);
+        }
+        else {
+            group.push(toolCall);
+        }
+    }
+    return groups;
+}
+/**
+ * A string result is passed through UNTOUCHED — re-encoding it would wrap it in
+ * quotes the model then has to see through. Only structured results are encoded.
+ */
+function stringifyToolOutput(result) {
+    if (typeof result === 'string') {
+        return result;
+    }
+    if (result === null) {
+        return '';
+    }
+    if (Array.isArray(result) || isJsonObject(result)) {
+        return canonicalJson(result);
+    }
+    return String(result);
+}
+/** Name whatever arrived, so the failure says which value it choked on. */
+function describeMessage(message) {
+    const type = isJsonObject(message) ? message.type : undefined;
+    return typeof type === 'string' ? type : String(type);
+}
+//# sourceMappingURL=message-map.js.map

package/dist/providers/openai/maps/message-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-map.js","sourceRoot":"","sources":["../../../../src/providers/openai/maps/message-map.ts"],"names":[],"mappings":"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"}

package/dist/providers/openai/maps/tool-choice-map.d.ts

@@ -0,0 +1,14 @@
+import type { JsonValue } from '../../../json.js';
+import { ToolChoice } from '../../../enums.js';
+/**
+ * Map a tool choice onto its wire form.
+ *
+ * A choice given as a STRING is a tool name and becomes an object; a choice
+ * given as an enum member becomes a bare string. Same argument, two JSON types.
+ *
+ * `Any` maps to `"required"` — the one member whose wire name differs from its
+ * own name, and the reason serializing the enum directly would send `"any"` and
+ * be rejected.
+ */
+export declare function mapToolChoice(toolChoice: string | ToolChoice | null): JsonValue | null;
+//# sourceMappingURL=tool-choice-map.d.ts.map

package/dist/providers/openai/maps/tool-choice-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-choice-map.d.ts","sourceRoot":"","sources":["../../../../src/providers/openai/maps/tool-choice-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAetF"}

package/dist/providers/openai/maps/tool-choice-map.js

@@ -0,0 +1,27 @@
+import { ToolChoice } from '../../../enums.js';
+/**
+ * Map a tool choice onto its wire form.
+ *
+ * A choice given as a STRING is a tool name and becomes an object; a choice
+ * given as an enum member becomes a bare string. Same argument, two JSON types.
+ *
+ * `Any` maps to `"required"` — the one member whose wire name differs from its
+ * own name, and the reason serializing the enum directly would send `"any"` and
+ * be rejected.
+ */
+export function mapToolChoice(toolChoice) {
+    if (typeof toolChoice === 'string') {
+        return { type: 'function', name: toolChoice };
+    }
+    switch (toolChoice) {
+        case ToolChoice.Auto:
+            return 'auto';
+        case ToolChoice.Any:
+            return 'required';
+        case ToolChoice.None:
+            return 'none';
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=tool-choice-map.js.map

package/dist/providers/openai/maps/tool-choice-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-choice-map.js","sourceRoot":"","sources":["../../../../src/providers/openai/maps/tool-choice-map.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,UAAsC;IAClE,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAChD,CAAC;IAED,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,UAAU,CAAC,IAAI;YAClB,OAAO,MAAM,CAAC;QAChB,KAAK,UAAU,CAAC,GAAG;YACjB,OAAO,UAAU,CAAC;QACpB,KAAK,UAAU,CAAC,IAAI;YAClB,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/providers/openai/maps/tool-map.d.ts

@@ -0,0 +1,16 @@
+import type { JsonObject } from '../../../json.js';
+import type { Tool } from '../../../tool.js';
+/**
+ * Map tools onto the Responses API's `tools` array.
+ *
+ * The whole mapped tool goes through a FALSINESS filter, not a not-null filter.
+ * That is why `strict: false` never reaches the wire even though `store: false`
+ * (a provider option, filtered on null) does. The inconsistency belongs to the
+ * reference and is reproduced rather than tidied: tidying it would change the
+ * bytes.
+ *
+ * Declaration order is preserved. Tool order reaches the model and influences
+ * which tool it picks.
+ */
+export declare function mapTools(tools: readonly Tool[]): JsonObject[];
+//# sourceMappingURL=tool-map.d.ts.map

package/dist/providers/openai/maps/tool-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-map.d.ts","sourceRoot":"","sources":["../../../../src/providers/openai/maps/tool-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAC;AAE9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,UAAU,EAAE,CAsB7D"}

package/dist/providers/openai/maps/tool-map.js

@@ -0,0 +1,34 @@
+import { dropFalsy } from '../../../internal/filters.js';
+/**
+ * Map tools onto the Responses API's `tools` array.
+ *
+ * The whole mapped tool goes through a FALSINESS filter, not a not-null filter.
+ * That is why `strict: false` never reaches the wire even though `store: false`
+ * (a provider option, filtered on null) does. The inconsistency belongs to the
+ * reference and is reproduced rather than tidied: tidying it would change the
+ * bytes.
+ *
+ * Declaration order is preserved. Tool order reaches the model and influences
+ * which tool it picks.
+ */
+export function mapTools(tools) {
+    return tools.map((tool) => {
+        const mapped = {
+            type: 'function',
+            name: tool.name(),
+            description: tool.description(),
+        };
+        if (tool.hasParameters()) {
+            mapped.parameters = {
+                type: 'object',
+                properties: tool.parametersAsObject(),
+                // `required` may legitimately be empty — the falsiness filter only ever
+                // runs over the TOP level of the mapped tool, never inside it.
+                required: [...tool.requiredParameters()],
+            };
+        }
+        mapped.strict = Boolean(tool.providerOptions('strict'));
+        return dropFalsy(mapped);
+    });
+}
+//# sourceMappingURL=tool-map.js.map

package/dist/providers/openai/maps/tool-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-map.js","sourceRoot":"","sources":["../../../../src/providers/openai/maps/tool-map.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGzD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAsB;IAC7C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,MAAM,GAA0C;YACpD,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;SAChC,CAAC;QAEF,IAAI,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;YACzB,MAAM,CAAC,UAAU,GAAG;gBAClB,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE;gBACrC,wEAAwE;gBACxE,+DAA+D;gBAC/D,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;aACzC,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;QAExD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/providers/openai/moderation.d.ts

@@ -0,0 +1,6 @@
+import { type JsonObject } from '../../json.js';
+import type { ModerationRequest } from '../../moderation/request.js';
+import { ModerationResponse } from '../../moderation/response.js';
+export declare function buildModerationBody(request: ModerationRequest): JsonObject;
+export declare function parseModerationResponse(rawBody: unknown, model: string): ModerationResponse;
+//# sourceMappingURL=moderation.d.ts.map

package/dist/providers/openai/moderation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moderation.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/moderation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAIlE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAE1E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAe3F"}

package/dist/providers/openai/moderation.js

@@ -0,0 +1,26 @@
+import { isJsonObject } from '../../json.js';
+import { PrismError } from '../../errors.js';
+import { ModerationResponse } from '../../moderation/response.js';
+import { Meta } from '../../value-objects/meta.js';
+import { ModerationResult } from '../../value-objects/moderation-result.js';
+export function buildModerationBody(request) {
+    return { model: request.model(), input: [...request.inputs()] };
+}
+export function parseModerationResponse(rawBody, model) {
+    if (!isJsonObject(rawBody)) {
+        // Refused rather than returning an empty response. An empty response has
+        // `isFlagged() === false`, so a caller gating on it would let the content
+        // through — a safety check that fails open on a malformed reply.
+        throw PrismError.providerResponseError('OpenAI returned an empty or non-object moderation response.');
+    }
+    const results = Array.isArray(rawBody.results) ? rawBody.results : [];
+    return new ModerationResponse({
+        results: results.map((result) => ModerationResult.fromObject(result)),
+        meta: new Meta(readString(rawBody.id), readString(rawBody.model) || model),
+        raw: rawBody,
+    });
+}
+function readString(value) {
+    return typeof value === 'string' ? value : '';
+}
+//# sourceMappingURL=moderation.js.map

package/dist/providers/openai/moderation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moderation.js","sourceRoot":"","sources":["../../../src/providers/openai/moderation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAmB,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAE5E,MAAM,UAAU,mBAAmB,CAAC,OAA0B;IAC5D,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB,EAAE,KAAa;IACrE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,yEAAyE;QACzE,0EAA0E;QAC1E,iEAAiE;QACjE,MAAM,UAAU,CAAC,qBAAqB,CAAC,6DAA6D,CAAC,CAAC;IACxG,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtE,OAAO,IAAI,kBAAkB,CAAC;QAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACrE,IAAI,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;QAC1E,GAAG,EAAE,OAAO;KACb,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC"}

package/dist/providers/openai/openai.d.ts

@@ -0,0 +1,103 @@
+import type { StructuredRequest } from '../../structured/request.js';
+import type { StructuredResponse } from '../../structured/response.js';
+import type { EmbeddingsRequest } from '../../embeddings/request.js';
+import type { EmbeddingsResponse } from '../../embeddings/response.js';
+import type { ImagesRequest } from '../../images/request.js';
+import type { ImagesResponse } from '../../images/response.js';
+import type { ModerationRequest } from '../../moderation/request.js';
+import type { ModerationResponse } from '../../moderation/response.js';
+import type { SpeechToTextRequest, TextToSpeechRequest } from '../../audio/request.js';
+import type { AudioResponse, AudioTextResponse } from '../../audio/response.js';
+import type { DeleteFileRequest, GetFileMetadataRequest, ListFilesRequest } from '../../files/request.js';
+import type { DeleteFileResult, FileData, FileListResult } from '../../files/file-data.js';
+import { DownloadFileRequest, UploadFileRequest } from '../../files/request.js';
+import type { BatchRequest, CancelBatchRequest, GetBatchResultsRequest, ListBatchesRequest } from '../../batch/request.js';
+import { RetrieveBatchRequest } from '../../batch/request.js';
+import type { BatchJob, BatchListResult, BatchResultItem } from '../../batch/batch-job.js';
+import type { HttpTransport } from '../../http/transport.js';
+import type { HttpBinaryTransport, HttpStreamTransport } from '../../http/transport.js';
+import type { StreamEvent } from '../../streaming/events.js';
+import type { TextRequest } from '../../text/request.js';
+import type { TextResponse } from '../../text/response.js';
+import { Provider } from '../provider.js';
+export interface OpenAIConfig {
+    apiKey?: string;
+    url?: string;
+    organization?: string | null;
+    project?: string | null;
+    /** Only `'responses'` is implemented; the chat-completions format is not ported. */
+    apiFormat?: string;
+    transport?: HttpTransport;
+    streamTransport?: HttpStreamTransport;
+    binaryTransport?: HttpBinaryTransport;
+}
+/**
+ * The OpenAI provider, Responses API only.
+ *
+ * Configuration is explicit first and environment second, so a test can pin
+ * every field and a deployment can set none of them.
+ */
+export declare class OpenAI extends Provider {
+    #private;
+    readonly providerName = "OpenAI";
+    readonly apiKey: string;
+    readonly url: string;
+    readonly organization: string | null;
+    readonly project: string | null;
+    readonly apiFormat: string;
+    constructor(config?: OpenAIConfig);
+    text(request: TextRequest): Promise<TextResponse>;
+    structured(request: StructuredRequest): Promise<StructuredResponse>;
+    /**
+     * The same generation, delivered as it arrives.
+     *
+     * `stream: true` is set here rather than in `buildRequestBody`, so the body a
+     * streamed call sends is provably the non-streamed body plus one key — the
+     * two cannot drift apart into different requests that happen to look alike.
+     */
+    stream(request: TextRequest): AsyncGenerator<StreamEvent>;
+    /**
+     * Vectors for one or more inputs.
+     *
+     * A different endpoint from the rest of this provider, so it does not go
+     * through `#send`: that helper posts to `/responses` and parses a text reply,
+     * and bending it to also mean `/embeddings` would make both harder to read
+     * than two short methods.
+     */
+    embeddings(request: EmbeddingsRequest): Promise<EmbeddingsResponse>;
+    images(request: ImagesRequest): Promise<ImagesResponse>;
+    moderation(request: ModerationRequest): Promise<ModerationResponse>;
+    textToSpeech(request: TextToSpeechRequest): Promise<AudioResponse>;
+    speechToText(request: SpeechToTextRequest): Promise<AudioTextResponse>;
+    uploadFile(request: UploadFileRequest): Promise<FileData>;
+    listFiles(request: ListFilesRequest): Promise<FileListResult>;
+    getFileMetadata(request: GetFileMetadataRequest): Promise<FileData>;
+    deleteFile(request: DeleteFileRequest): Promise<DeleteFileResult>;
+    /**
+     * The file's bytes, returned WITHOUT being decoded.
+     *
+     * The only file operation that does not go through `#file`, because that
+     * helper's job is to decode JSON and this one must not: a downloaded PDF run
+     * through a JSON parse comes back as null, and the failure would look like an
+     * empty file rather than a decode that should never have happened.
+     */
+    downloadFile(request: DownloadFileRequest): Promise<Uint8Array>;
+    batch(request: BatchRequest): Promise<BatchJob>;
+    retrieveBatch(request: RetrieveBatchRequest): Promise<BatchJob>;
+    listBatches(request: ListBatchesRequest): Promise<BatchListResult>;
+    cancelBatch(request: CancelBatchRequest): Promise<BatchJob>;
+    /**
+     * Every result in a batch, from the files it wrote.
+     *
+     * BOTH files are read, output and error, because a batch where some requests
+     * succeeded and others failed writes to both — reading only the output file
+     * would silently drop every failure and report a clean run.
+     *
+     * An unfinished batch has neither, and answers with an empty list rather than
+     * an error: nothing went wrong, there is just nothing yet.
+     */
+    getBatchResults(request: GetBatchResultsRequest): Promise<readonly BatchResultItem[]>;
+    /** Optional headers are OMITTED rather than sent empty when unconfigured. */
+    headers(): Record<string, string>;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/providers/openai/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/openai.ts"],"names":[],"mappings":"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"}