@urun-sh/openai 0.2.26

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 urun contributors
+
+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/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var U=Object.create;var m=Object.defineProperty;var D=Object.getOwnPropertyDescriptor;var q=Object.getOwnPropertyNames;var $=Object.getPrototypeOf,j=Object.prototype.hasOwnProperty;var H=(n,e)=>{for(var t in e)m(n,t,{get:e[t],enumerable:!0})},_=(n,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of q(e))!j.call(n,o)&&o!==t&&m(n,o,{get:()=>e[o],enumerable:!(r=D(e,o))||r.enumerable});return n};var v=(n,e,t)=>(t=n!=null?U($(n)):{},_(e||!n||!n.__esModule?m(t,"default",{value:n,enumerable:!0}):t,n)),N=n=>_(m({},"__esModule",{value:!0}),n);var G={};H(G,{SUPPORTED_REALTIME_CLIENT_EVENTS:()=>h,SUPPORTED_RESPONSES_EVENTS:()=>S,UrunRealtime:()=>k,UrunResponses:()=>y,isSupportedClientEvent:()=>L,isSupportedResponsesEvent:()=>P,listModels:()=>T,nodeAudioBackend:()=>R,toErrorEvent:()=>d,weriftAudioBackend:()=>A});module.exports=N(G);function b(n,e,t,r){let o=n.response??{},s={request_id:t,consumer_id:r,stream:!0,kind:"chat",messages:e};return typeof o.instructions=="string"&&(s.instructions=o.instructions),Array.isArray(o.modalities)&&(s.modalities=o.modalities),typeof o.temperature=="number"&&(s.temperature=o.temperature),typeof o.max_output_tokens=="number"&&(s.max_output_tokens=o.max_output_tokens),o.tools!==void 0&&(s.tools=o.tools),s}function E(n,e,t){let r={request_id:e,consumer_id:t,stream:!!n.stream,kind:"responses",input:n.input};return n.model&&(r.model=n.model),n.tools!==void 0&&(r.tools=n.tools),typeof n.temperature=="number"&&(r.temperature=n.temperature),typeof n.max_output_tokens=="number"&&(r.max_output_tokens=n.max_output_tokens),r}function d(n){if(n instanceof Error)return{type:"error",error:{type:"urun_error",code:n.name||null,message:n.message}};if(n&&typeof n=="object"&&n.t==="error"){let e=n,t=e.body??{};return{type:"error",error:{type:"urun_error",code:e.code??null,message:t.message??"unknown error"}}}return{type:"error",error:{type:"urun_error",code:null,message:String(n)}}}var W="llm-resp";async function*g(n,e){let t=`${W}:${e}`,r=`resp_${e}`;yield{type:"response.created",response:{id:r,status:"in_progress"}};for await(let o of n.stream(t).messages()){let s=o;if(s.t==="delta")yield{type:"response.output_text.delta",item_id:r,delta:s.delta};else if(s.t==="response"){yield{type:"response.completed",response:{id:r,status:"completed",...s.body}};return}else if(s.t==="error"){yield d(s);return}}}var F="llm",c=class{constructor(e){this.session=e}session;get consumerId(){return this.session.consumerId}write(e){this.session.doc(F).set({requests:{[e.request_id]:{payload:e,consumer_id:e.consumer_id,stream:e.stream}}})}sendResponses(e,t){let r=E(e,t,this.consumerId);return this.write(r),g(this.session,t)}sendResponseCreate(e,t,r){let o=b(e,t,r,this.consumerId);return this.write(o),g(this.session,r)}};var f=class{constructor(e,t){this.backend=e;this.opts=t}backend;opts;source=null;sink=null;outHandlers=new Set;async startOutbound(){return this.source=this.backend.createSource(),this.source.track}appendInputAudio(e){if(!this.source)throw new Error("startOutbound() not called");let t=Buffer.from(e,"base64"),r=Math.floor(t.byteLength/2),o=new Int16Array(r);for(let s=0;s<r;s++)o[s]=t.readInt16LE(s*2);this.source.onData(o)}async startInbound(e){if(e==null)throw new Error('startInbound: no downstream audio track \u2014 the runtime audio producer has not been consumed yet (session.stream("rt-audio-out").track is null)');this.sink=this.backend.createSink(e),this.sink.onframe=t=>{let r=Buffer.from(t.samples.buffer,t.samples.byteOffset,t.samples.byteLength).toString("base64");for(let o of this.outHandlers)o(r)}}onOutputAudio(e){return this.outHandlers.add(e),()=>this.outHandlers.delete(e)}},K=24e3,l=480,V=111;async function Y(){let n=await import("opusscript"),e=n.default??n;return new e(K,1,2048)}async function A(){let n=await import("werift"),e=await Y();return{createSource:()=>{let t=new n.MediaStreamTrack({kind:"audio"}),r=Math.random()*4294967295>>>0,o=Math.random()*65535&65535,s=Math.random()*4294967295>>>0,i=new Int16Array(0);return{track:t,onData:u=>{let a=new Int16Array(i.length+u.length);a.set(i,0),a.set(u,i.length);let p=0;for(;a.length-p>=l;){let w=a.subarray(p,p+l);p+=l;let O=Buffer.from(w.buffer,w.byteOffset,w.byteLength),B=e.encode(O,l);o=o+1&65535,s=s+l>>>0;let M=new n.RtpHeader({version:2,payloadType:V,sequenceNumber:o,timestamp:s,ssrc:r,marker:!1}),C=new n.RtpPacket(M,B);t.writeRtp(C)}i=a.slice(p)}}},createSink:t=>{let r={onframe:null};return t.onReceiveRtp.subscribe(s=>{let i;try{i=e.decode(s.payload)}catch{return}let u=new Int16Array(i.length/2);for(let a=0;a<u.length;a++)u[a]=i.readInt16LE(a*2);r.onframe?.({samples:u})}),r}}}async function R(){let n=await import("@roamhq/wrtc");return{createSource:()=>{let e=new n.nonstandard.RTCAudioSource;return{track:e.createTrack(),onData:r=>e.onData({samples:r,sampleRate:24e3})}},createSink:e=>{let t={onframe:null},r=new n.nonstandard.RTCAudioSink(e);return r.ondata=o=>{t.onframe?.(o)},t}}}var x=0;function z(){return x+=1,`rt_${Date.now().toString(36)}_${x.toString(36)}`}var k=class{constructor(e,t={}){this.session=e;this.opts=t;this.transport=new c(e)}session;opts;transport;handlers=new Set;conversation=[];active=null;audio=null;currentRequestId=null;async enableAudio(){if(!this.opts.audioBackend)throw new Error("audioBackend required for audio");this.audio=new f(this.opts.audioBackend,{sampleRate:24e3});let e=await this.audio.startOutbound();await this.session.stream("rt-audio-in").attach(e),this.audio.onOutputAudio(r=>this.emit({type:"response.audio.delta",delta:r}));let t=await this.awaitDownstreamAudioTrack();await this.audio.startInbound(t)}awaitDownstreamAudioTrack(e=1e4){let t=this.session.stream("rt-audio-out");return t.track!=null?Promise.resolve(t.track):new Promise((r,o)=>{let s,i=setTimeout(()=>{s?.(),o(new Error(`enableAudio: no downstream audio track within ${e}ms (runtime produced no voice OUT / SFU audio consumer never attached)`))},e),u=a=>{a!=null&&(clearTimeout(i),s?.(),r(a))};s=t.on?.("track",u),t.track!=null&&u(t.track)})}on(e,t){return this.handlers.add(t),()=>this.handlers.delete(t)}emit(e){for(let t of this.handlers)t(e)}send(e){switch(e.type){case"conversation.item.create":{let t=(e.item?.content??[]).map(r=>r.text??"").join("");this.conversation.push({role:e.item?.role??"user",content:t});return}case"response.create":{let t=z();this.currentRequestId=t;let r=this.transport.sendResponseCreate({type:"response.create",response:e.response},this.conversation,t);this.active=(async()=>{try{for await(let o of r)this.emit(o)}catch(o){this.emit(d(o))}})();return}case"input_audio_buffer.append":this.audio?.appendInputAudio(e.audio);return;case"input_audio_buffer.commit":case"input_audio_buffer.clear":return;case"response.cancel":return;default:return}}async drain(){this.active&&await this.active}};var I=0;function X(){return I+=1,`req_${Date.now().toString(36)}_${I.toString(36)}`}var y=class{transport;constructor(e){this.transport=new c(e)}responses={create:async e=>{let t=X(),r=this.transport.sendResponses(e,t);return Object.assign((async function*(){yield*r})(),{requestId:t})}}};async function T(n){let t=await(n.fetchImpl??fetch)(`${n.catalogUrl}/model_catalog?select=model_id,variant`,{headers:{apikey:n.anonKey,Authorization:`Bearer ${n.anonKey}`}});if(!t.ok)throw new Error(`model_catalog fetch failed: ${t.status}`);return{object:"list",data:(await t.json()).map(o=>({id:`${o.model_id}:${o.variant}`,object:"model",created:0,owned_by:"urun"}))}}var h=["session.update","conversation.item.create","response.create","response.cancel","input_audio_buffer.append","input_audio_buffer.commit","input_audio_buffer.clear"],S=["response.created","response.output_text.delta","response.output_item.added","response.function_call_arguments.delta","response.image_generation_call.partial_image","response.completed","error"];function L(n){return h.includes(n)}function P(n){return S.includes(n)}0&&(module.exports={SUPPORTED_REALTIME_CLIENT_EVENTS,SUPPORTED_RESPONSES_EVENTS,UrunRealtime,UrunResponses,isSupportedClientEvent,isSupportedResponsesEvent,listModels,nodeAudioBackend,toErrorEvent,weriftAudioBackend});

package/dist/index.d.cts

@@ -0,0 +1,174 @@
+export { RealtimeClientEvent, RealtimeServerEvent } from 'openai/resources/beta/realtime/realtime';
+export { ResponseStreamEvent } from 'openai/resources/responses/responses';
+
+/** The narrow subset of @urun-sh/core's Session the SDK depends on. */
+interface UrunDocLike {
+    set(patch: Record<string, unknown>): void;
+    get(path?: string, defaultValue?: unknown): unknown;
+    on(event: 'change', handler: (snapshot: Record<string, unknown>) => void): () => void;
+}
+interface UrunStreamLike {
+    messages(): AsyncIterable<unknown>;
+    attach(track: unknown): Promise<void>;
+    detach(): Promise<void>;
+    readonly track: unknown;
+    /**
+     * Subscribe to the named media track (de)appearing. The downstream audio track
+     * is consumed ASYNCHRONOUSLY after the WebRTC handshake, so `track` may be null
+     * at `enableAudio()` time; this fires with the real `MediaStreamTrack` the
+     * moment the consumer attaches (core `SessionStream.on('track')`). Optional so
+     * non-media test doubles need not implement it.
+     */
+    on?(event: 'track', handler: (track: unknown) => void): () => void;
+}
+interface UrunSessionLike {
+    /** Per-leg consumer identity (core: transport.consumerId). */
+    readonly consumerId: string;
+    doc(key: string): UrunDocLike;
+    stream(name: string): UrunStreamLike;
+    close?(): Promise<void> | void;
+}
+/** Lane message shape emitted by the serve runtime (core session.ts:83). */
+type LaneMessage = {
+    t: 'delta';
+    request_id?: string;
+    delta: string;
+} | {
+    t: 'response';
+    request_id?: string;
+    body: unknown;
+} | {
+    t: 'error';
+    request_id?: string;
+    body: unknown;
+    code?: string;
+};
+
+/** Pluggable audio backend so tests don't need real WebRTC. In production, `nodeAudioBackend()` wraps @roamhq/wrtc. */
+interface AudioSource {
+    track: unknown;
+    onData(frame: Int16Array): void;
+}
+interface AudioSink {
+    onframe: ((frame: {
+        samples: Int16Array;
+    }) => void) | null;
+}
+interface AudioBackend {
+    createSource(): AudioSource;
+    /**
+     * Build a sink that pulls PCM16 frames OFF the runtime's downstream audio
+     * track (`remoteTrack`, the real Opus `MediaStreamTrack` the SFU now produces
+     * — see session-server-ts audio ingest). The production backend wires a real
+     * `RTCAudioSink(remoteTrack)`; the sink's `onframe` is invoked per decoded
+     * 10ms frame. `remoteTrack` is REQUIRED — a missing track is a wiring bug, not
+     * a silent no-op (a dead sink is exactly the placeholder this replaces).
+     */
+    createSink(remoteTrack: unknown): AudioSink;
+}
+/**
+ * Production backend for the werift transport (@urun-sh/core). Replaces the
+ * wrtc backend, whose `RTCAudioSink`/`RTCAudioSource` are incompatible with
+ * werift's read-only-`id` `MediaStreamTrack`.
+ */
+declare function weriftAudioBackend(): Promise<AudioBackend>;
+/**
+ * @deprecated wrtc backend — INCOMPATIBLE with @urun-sh/core's werift transport
+ * (its `RTCAudioSink`/`RTCAudioSource` set the foreign track's read-only `id`).
+ * Use {@link weriftAudioBackend}. Kept for any non-werift transport.
+ */
+declare function nodeAudioBackend(): Promise<AudioBackend>;
+
+type ServerEventHandler = (ev: unknown) => void;
+interface RealtimeClientEventLike {
+    type: string;
+    item?: {
+        role: string;
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+    };
+    response?: Record<string, unknown>;
+}
+declare class UrunRealtime {
+    private readonly session;
+    private readonly opts;
+    private readonly transport;
+    private readonly handlers;
+    private conversation;
+    private active;
+    private audio;
+    currentRequestId: string | null;
+    constructor(session: UrunSessionLike, opts?: {
+        audioBackend?: AudioBackend;
+    });
+    enableAudio(): Promise<void>;
+    /**
+     * Resolve the downstream audio `MediaStreamTrack`: immediately if already
+     * consumed, otherwise on the first `track` event from the `rt-audio-out`
+     * stream. Times out (default 10s) so `enableAudio` cannot hang forever if the
+     * runtime never produces voice OUT (e.g. a video-only app).
+     */
+    private awaitDownstreamAudioTrack;
+    on(_event: 'server_event', handler: ServerEventHandler): () => void;
+    private emit;
+    /** OpenAI Realtime client-event entrypoint. */
+    send(ev: RealtimeClientEventLike): void;
+    /** Await the in-flight response turn (test + flush helper). */
+    drain(): Promise<void>;
+}
+
+interface ResponsesStream extends AsyncIterable<unknown> {
+    readonly requestId: string;
+}
+declare class UrunResponses {
+    private readonly transport;
+    constructor(session: UrunSessionLike);
+    readonly responses: {
+        create: (params: {
+            model?: string;
+            input: unknown;
+            stream?: boolean;
+            tools?: unknown;
+            temperature?: number;
+            max_output_tokens?: number;
+        }) => Promise<ResponsesStream>;
+    };
+}
+
+interface ModelObject {
+    id: string;
+    object: 'model';
+    created: number;
+    owned_by: string;
+}
+interface ModelList {
+    object: 'list';
+    data: ModelObject[];
+}
+declare function listModels(opts: {
+    catalogUrl: string;
+    anonKey: string;
+    fetchImpl?: typeof fetch;
+}): Promise<ModelList>;
+
+interface OpenAIErrorEvent {
+    type: 'error';
+    error: {
+        type: string;
+        code: string | null;
+        message: string;
+        param?: string | null;
+    };
+}
+declare function toErrorEvent(fault: LaneMessage | Error | unknown): OpenAIErrorEvent;
+
+/** The Realtime client-events the SDK maps in v1. */
+declare const SUPPORTED_REALTIME_CLIENT_EVENTS: readonly ["session.update", "conversation.item.create", "response.create", "response.cancel", "input_audio_buffer.append", "input_audio_buffer.commit", "input_audio_buffer.clear"];
+/** The Responses streaming events the SDK emits in v1. */
+declare const SUPPORTED_RESPONSES_EVENTS: readonly ["response.created", "response.output_text.delta", "response.output_item.added", "response.function_call_arguments.delta", "response.image_generation_call.partial_image", "response.completed", "error"];
+declare function isSupportedClientEvent(type: string): boolean;
+declare function isSupportedResponsesEvent(type: string): boolean;
+
+export { type AudioBackend, type AudioSink, type AudioSource, type LaneMessage, type ModelList, type ModelObject, type OpenAIErrorEvent, SUPPORTED_REALTIME_CLIENT_EVENTS, SUPPORTED_RESPONSES_EVENTS, UrunRealtime, UrunResponses, type UrunSessionLike, isSupportedClientEvent, isSupportedResponsesEvent, listModels, nodeAudioBackend, toErrorEvent, weriftAudioBackend };

package/dist/index.d.ts

@@ -0,0 +1,145 @@
+export { RealtimeClientEvent, RealtimeServerEvent } from 'openai/resources/beta/realtime/realtime';
+export { ResponseStreamEvent } from 'openai/resources/responses/responses';
+
+interface UrunDocLike {
+    set(patch: Record<string, unknown>): void;
+    get(path?: string, defaultValue?: unknown): unknown;
+    on(event: 'change', handler: (snapshot: Record<string, unknown>) => void): () => void;
+}
+interface UrunStreamLike {
+    messages(): AsyncIterable<unknown>;
+    attach(track: unknown): Promise<void>;
+    detach(): Promise<void>;
+    readonly track: unknown;
+    
+    on?(event: 'track', handler: (track: unknown) => void): () => void;
+}
+interface UrunSessionLike {
+    
+    readonly consumerId: string;
+    doc(key: string): UrunDocLike;
+    stream(name: string): UrunStreamLike;
+    close?(): Promise<void> | void;
+}
+
+type LaneMessage = {
+    t: 'delta';
+    request_id?: string;
+    delta: string;
+} | {
+    t: 'response';
+    request_id?: string;
+    body: unknown;
+} | {
+    t: 'error';
+    request_id?: string;
+    body: unknown;
+    code?: string;
+};
+
+interface AudioSource {
+    track: unknown;
+    onData(frame: Int16Array): void;
+}
+interface AudioSink {
+    onframe: ((frame: {
+        samples: Int16Array;
+    }) => void) | null;
+}
+interface AudioBackend {
+    createSource(): AudioSource;
+    
+    createSink(remoteTrack: unknown): AudioSink;
+}
+
+declare function weriftAudioBackend(): Promise<AudioBackend>;
+
+declare function nodeAudioBackend(): Promise<AudioBackend>;
+
+type ServerEventHandler = (ev: unknown) => void;
+interface RealtimeClientEventLike {
+    type: string;
+    item?: {
+        role: string;
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+    };
+    response?: Record<string, unknown>;
+}
+declare class UrunRealtime {
+    private readonly session;
+    private readonly opts;
+    private readonly transport;
+    private readonly handlers;
+    private conversation;
+    private active;
+    private audio;
+    currentRequestId: string | null;
+    constructor(session: UrunSessionLike, opts?: {
+        audioBackend?: AudioBackend;
+    });
+    enableAudio(): Promise<void>;
+    
+    private awaitDownstreamAudioTrack;
+    on(_event: 'server_event', handler: ServerEventHandler): () => void;
+    private emit;
+    
+    send(ev: RealtimeClientEventLike): void;
+    
+    drain(): Promise<void>;
+}
+
+interface ResponsesStream extends AsyncIterable<unknown> {
+    readonly requestId: string;
+}
+declare class UrunResponses {
+    private readonly transport;
+    constructor(session: UrunSessionLike);
+    readonly responses: {
+        create: (params: {
+            model?: string;
+            input: unknown;
+            stream?: boolean;
+            tools?: unknown;
+            temperature?: number;
+            max_output_tokens?: number;
+        }) => Promise<ResponsesStream>;
+    };
+}
+
+interface ModelObject {
+    id: string;
+    object: 'model';
+    created: number;
+    owned_by: string;
+}
+interface ModelList {
+    object: 'list';
+    data: ModelObject[];
+}
+declare function listModels(opts: {
+    catalogUrl: string;
+    anonKey: string;
+    fetchImpl?: typeof fetch;
+}): Promise<ModelList>;
+
+interface OpenAIErrorEvent {
+    type: 'error';
+    error: {
+        type: string;
+        code: string | null;
+        message: string;
+        param?: string | null;
+    };
+}
+declare function toErrorEvent(fault: LaneMessage | Error | unknown): OpenAIErrorEvent;
+
+declare const SUPPORTED_REALTIME_CLIENT_EVENTS: readonly ["session.update", "conversation.item.create", "response.create", "response.cancel", "input_audio_buffer.append", "input_audio_buffer.commit", "input_audio_buffer.clear"];
+
+declare const SUPPORTED_RESPONSES_EVENTS: readonly ["response.created", "response.output_text.delta", "response.output_item.added", "response.function_call_arguments.delta", "response.image_generation_call.partial_image", "response.completed", "error"];
+declare function isSupportedClientEvent(type: string): boolean;
+declare function isSupportedResponsesEvent(type: string): boolean;
+
+export { type AudioBackend, type AudioSink, type AudioSource, type LaneMessage, type ModelList, type ModelObject, type OpenAIErrorEvent, SUPPORTED_REALTIME_CLIENT_EVENTS, SUPPORTED_RESPONSES_EVENTS, UrunRealtime, UrunResponses, type UrunSessionLike, isSupportedClientEvent, isSupportedResponsesEvent, listModels, nodeAudioBackend, toErrorEvent, weriftAudioBackend };

package/dist/index.js

@@ -0,0 +1 @@
+function v(n,e,t,r){let o=n.response??{},s={request_id:t,consumer_id:r,stream:!0,kind:"chat",messages:e};return typeof o.instructions=="string"&&(s.instructions=o.instructions),Array.isArray(o.modalities)&&(s.modalities=o.modalities),typeof o.temperature=="number"&&(s.temperature=o.temperature),typeof o.max_output_tokens=="number"&&(s.max_output_tokens=o.max_output_tokens),o.tools!==void 0&&(s.tools=o.tools),s}function g(n,e,t){let r={request_id:e,consumer_id:t,stream:!!n.stream,kind:"responses",input:n.input};return n.model&&(r.model=n.model),n.tools!==void 0&&(r.tools=n.tools),typeof n.temperature=="number"&&(r.temperature=n.temperature),typeof n.max_output_tokens=="number"&&(r.max_output_tokens=n.max_output_tokens),r}function p(n){if(n instanceof Error)return{type:"error",error:{type:"urun_error",code:n.name||null,message:n.message}};if(n&&typeof n=="object"&&n.t==="error"){let e=n,t=e.body??{};return{type:"error",error:{type:"urun_error",code:e.code??null,message:t.message??"unknown error"}}}return{type:"error",error:{type:"urun_error",code:null,message:String(n)}}}var I="llm-resp";async function*k(n,e){let t=`${I}:${e}`,r=`resp_${e}`;yield{type:"response.created",response:{id:r,status:"in_progress"}};for await(let o of n.stream(t).messages()){let s=o;if(s.t==="delta")yield{type:"response.output_text.delta",item_id:r,delta:s.delta};else if(s.t==="response"){yield{type:"response.completed",response:{id:r,status:"completed",...s.body}};return}else if(s.t==="error"){yield p(s);return}}}var T="llm",d=class{constructor(e){this.session=e}session;get consumerId(){return this.session.consumerId}write(e){this.session.doc(T).set({requests:{[e.request_id]:{payload:e,consumer_id:e.consumer_id,stream:e.stream}}})}sendResponses(e,t){let r=g(e,t,this.consumerId);return this.write(r),k(this.session,t)}sendResponseCreate(e,t,r){let o=v(e,t,r,this.consumerId);return this.write(o),k(this.session,r)}};var m=class{constructor(e,t){this.backend=e;this.opts=t}backend;opts;source=null;sink=null;outHandlers=new Set;async startOutbound(){return this.source=this.backend.createSource(),this.source.track}appendInputAudio(e){if(!this.source)throw new Error("startOutbound() not called");let t=Buffer.from(e,"base64"),r=Math.floor(t.byteLength/2),o=new Int16Array(r);for(let s=0;s<r;s++)o[s]=t.readInt16LE(s*2);this.source.onData(o)}async startInbound(e){if(e==null)throw new Error('startInbound: no downstream audio track \u2014 the runtime audio producer has not been consumed yet (session.stream("rt-audio-out").track is null)');this.sink=this.backend.createSink(e),this.sink.onframe=t=>{let r=Buffer.from(t.samples.buffer,t.samples.byteOffset,t.samples.byteLength).toString("base64");for(let o of this.outHandlers)o(r)}}onOutputAudio(e){return this.outHandlers.add(e),()=>this.outHandlers.delete(e)}},L=24e3,l=480,P=111;async function O(){let n=await import("opusscript"),e=n.default??n;return new e(L,1,2048)}async function B(){let n=await import("werift"),e=await O();return{createSource:()=>{let t=new n.MediaStreamTrack({kind:"audio"}),r=Math.random()*4294967295>>>0,o=Math.random()*65535&65535,s=Math.random()*4294967295>>>0,i=new Int16Array(0);return{track:t,onData:u=>{let a=new Int16Array(i.length+u.length);a.set(i,0),a.set(u,i.length);let c=0;for(;a.length-c>=l;){let f=a.subarray(c,c+l);c+=l;let E=Buffer.from(f.buffer,f.byteOffset,f.byteLength),A=e.encode(E,l);o=o+1&65535,s=s+l>>>0;let R=new n.RtpHeader({version:2,payloadType:P,sequenceNumber:o,timestamp:s,ssrc:r,marker:!1}),x=new n.RtpPacket(R,A);t.writeRtp(x)}i=a.slice(c)}}},createSink:t=>{let r={onframe:null};return t.onReceiveRtp.subscribe(s=>{let i;try{i=e.decode(s.payload)}catch{return}let u=new Int16Array(i.length/2);for(let a=0;a<u.length;a++)u[a]=i.readInt16LE(a*2);r.onframe?.({samples:u})}),r}}}async function M(){let n=await import("@roamhq/wrtc");return{createSource:()=>{let e=new n.nonstandard.RTCAudioSource;return{track:e.createTrack(),onData:r=>e.onData({samples:r,sampleRate:24e3})}},createSink:e=>{let t={onframe:null},r=new n.nonstandard.RTCAudioSink(e);return r.ondata=o=>{t.onframe?.(o)},t}}}var h=0;function C(){return h+=1,`rt_${Date.now().toString(36)}_${h.toString(36)}`}var y=class{constructor(e,t={}){this.session=e;this.opts=t;this.transport=new d(e)}session;opts;transport;handlers=new Set;conversation=[];active=null;audio=null;currentRequestId=null;async enableAudio(){if(!this.opts.audioBackend)throw new Error("audioBackend required for audio");this.audio=new m(this.opts.audioBackend,{sampleRate:24e3});let e=await this.audio.startOutbound();await this.session.stream("rt-audio-in").attach(e),this.audio.onOutputAudio(r=>this.emit({type:"response.audio.delta",delta:r}));let t=await this.awaitDownstreamAudioTrack();await this.audio.startInbound(t)}awaitDownstreamAudioTrack(e=1e4){let t=this.session.stream("rt-audio-out");return t.track!=null?Promise.resolve(t.track):new Promise((r,o)=>{let s,i=setTimeout(()=>{s?.(),o(new Error(`enableAudio: no downstream audio track within ${e}ms (runtime produced no voice OUT / SFU audio consumer never attached)`))},e),u=a=>{a!=null&&(clearTimeout(i),s?.(),r(a))};s=t.on?.("track",u),t.track!=null&&u(t.track)})}on(e,t){return this.handlers.add(t),()=>this.handlers.delete(t)}emit(e){for(let t of this.handlers)t(e)}send(e){switch(e.type){case"conversation.item.create":{let t=(e.item?.content??[]).map(r=>r.text??"").join("");this.conversation.push({role:e.item?.role??"user",content:t});return}case"response.create":{let t=C();this.currentRequestId=t;let r=this.transport.sendResponseCreate({type:"response.create",response:e.response},this.conversation,t);this.active=(async()=>{try{for await(let o of r)this.emit(o)}catch(o){this.emit(p(o))}})();return}case"input_audio_buffer.append":this.audio?.appendInputAudio(e.audio);return;case"input_audio_buffer.commit":case"input_audio_buffer.clear":return;case"response.cancel":return;default:return}}async drain(){this.active&&await this.active}};var S=0;function U(){return S+=1,`req_${Date.now().toString(36)}_${S.toString(36)}`}var w=class{transport;constructor(e){this.transport=new d(e)}responses={create:async e=>{let t=U(),r=this.transport.sendResponses(e,t);return Object.assign((async function*(){yield*r})(),{requestId:t})}}};async function D(n){let t=await(n.fetchImpl??fetch)(`${n.catalogUrl}/model_catalog?select=model_id,variant`,{headers:{apikey:n.anonKey,Authorization:`Bearer ${n.anonKey}`}});if(!t.ok)throw new Error(`model_catalog fetch failed: ${t.status}`);return{object:"list",data:(await t.json()).map(o=>({id:`${o.model_id}:${o.variant}`,object:"model",created:0,owned_by:"urun"}))}}var _=["session.update","conversation.item.create","response.create","response.cancel","input_audio_buffer.append","input_audio_buffer.commit","input_audio_buffer.clear"],b=["response.created","response.output_text.delta","response.output_item.added","response.function_call_arguments.delta","response.image_generation_call.partial_image","response.completed","error"];function q(n){return _.includes(n)}function $(n){return b.includes(n)}export{_ as SUPPORTED_REALTIME_CLIENT_EVENTS,b as SUPPORTED_RESPONSES_EVENTS,y as UrunRealtime,w as UrunResponses,q as isSupportedClientEvent,$ as isSupportedResponsesEvent,D as listModels,M as nodeAudioBackend,p as toErrorEvent,B as weriftAudioBackend};

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@urun-sh/openai",
+  "version": "0.2.26",
+  "description": "OpenAI-compatible Realtime + Responses SDK over uRun session primitives (not websockets).",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@urun-sh/core": "^0.2.26"
+  },
+  "dependencies": {
+    "openai": "4.104.0"
+  },
+  "optionalDependencies": {
+    "@roamhq/wrtc": "^0.8.0",
+    "werift": "^0.23.0",
+    "opusscript": "^0.1.1"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "vitest": "^3.0.0",
+    "werift": "^0.23.0",
+    "opusscript": "^0.1.1",
+    "happy-dom": "^20.9.0",
+    "typescript": "^5.3.0",
+    "@types/node": "^24.0.0",
+    "@urun-sh/core": "0.2.26"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup && node ../../scripts/sanitize-dist.mjs .",
+    "test": "vitest run",
+    "dev": "tsup --watch"
+  }
+}