@mlx-node/server 0.0.0

package/dist/transport-visibility.js

@@ -0,0 +1,161 @@
+/**
+ * Transport visibility tracking shared between the Responses and Messages
+ * endpoints. Gates "safe to suppress" on whether the client actually observed
+ * a terminal artefact for this turn.
+ *
+ * The helpers reject — and leave visibility flags unflipped — on ANY of:
+ *   - the write callback reporting err != null;
+ *   - a `'error'` event on `res`;
+ *   - a `'close'` event on `res` or its socket;
+ *   - a pre-write check finding the response/socket already destroyed.
+ *
+ * Flipping the flags from `res.end()` / `writeSSEEvent`'s synchronous return
+ * is not sufficient: on a dead socket `_writeRaw` can return without ever
+ * firing the callback or `'error'`, which would pin the per-model mutex on a
+ * client that cannot see anything we write.
+ *
+ * Non-terminal SSE writes remain synchronous — only the terminal event is
+ * flushed through the async helper. Streaming handlers independently attach a
+ * `res.once('close', …)` listener to flip `clientAborted` so the decode loop
+ * breaks at the next iteration boundary.
+ */
+import { writeSSEEvent } from './streaming.js';
+export function createVisibility() {
+    return {
+        responseMode: null,
+        responseBodyWritten: false,
+        terminalEmitted: false,
+    };
+}
+/** True if `res` or its socket is already destroyed — writes will never be seen and callbacks may never fire. */
+function isSocketGone(res) {
+    if (res.destroyed)
+        return true;
+    const sock = res.socket;
+    if (sock != null && sock.destroyed)
+        return true;
+    return false;
+}
+/**
+ * Write an HTTP 200 JSON response and await kernel ack via `res.end(body, cb)`.
+ * `responseMode` is committed AFTER `writeHead` returns so a synchronous throw
+ * from `writeHead` leaves `responseMode === null` for the outer catch.
+ * `responseBodyWritten` is flipped only on the callback's success path.
+ */
+export async function endJson(res, body, visibility) {
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    visibility.responseMode = 'json';
+    await new Promise((resolve, reject) => {
+        let settled = false;
+        const onError = (err) => {
+            settle(err instanceof Error ? err : new Error(String(err)));
+        };
+        const onClose = () => {
+            // `'close'` without a successful end callback = client never saw the body.
+            settle(new Error('response closed before write completion'));
+        };
+        const sock = res.socket;
+        const settle = (err) => {
+            if (settled)
+                return;
+            settled = true;
+            res.removeListener('error', onError);
+            res.removeListener('close', onClose);
+            if (sock != null)
+                sock.removeListener('close', onClose);
+            if (err != null) {
+                reject(err);
+            }
+            else {
+                visibility.responseBodyWritten = true;
+                resolve();
+            }
+        };
+        // Pre-check: `'close'` may have already fired and the write callback
+        // may never arrive on a destroyed peer — reject synchronously instead.
+        if (isSocketGone(res)) {
+            settle(new Error('response socket already destroyed before write'));
+            return;
+        }
+        res.once('error', onError);
+        res.once('close', onClose);
+        if (sock != null)
+            sock.once('close', onClose);
+        try {
+            res.end(body, (err) => {
+                settle(err ?? null);
+            });
+        }
+        catch (err) {
+            settle(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+/**
+ * Emit the terminal SSE event for a streaming response and await kernel ack via
+ * `res.write(chunk, cb)`. `terminalEmitted` is flipped only on the success path.
+ * Used for `response.completed` / `response.failed`, `message_stop`, and the
+ * streaming `error` event. Non-terminal writes stay synchronous.
+ */
+export async function flushTerminalSSE(res, eventType, data, visibility) {
+    const payload = { type: eventType, ...data };
+    const chunk = `event: ${eventType}\ndata: ${JSON.stringify(payload)}\n\n`;
+    await new Promise((resolve, reject) => {
+        let settled = false;
+        const onError = (err) => {
+            settle(err instanceof Error ? err : new Error(String(err)));
+        };
+        const onClose = () => {
+            settle(new Error('response closed before terminal SSE write completion'));
+        };
+        const sock = res.socket;
+        const settle = (err) => {
+            if (settled)
+                return;
+            settled = true;
+            res.removeListener('error', onError);
+            res.removeListener('close', onClose);
+            if (sock != null)
+                sock.removeListener('close', onClose);
+            if (err != null) {
+                reject(err);
+            }
+            else {
+                visibility.terminalEmitted = true;
+                resolve();
+            }
+        };
+        if (isSocketGone(res)) {
+            settle(new Error('response socket already destroyed before terminal SSE write'));
+            return;
+        }
+        res.once('error', onError);
+        res.once('close', onClose);
+        if (sock != null)
+            sock.once('close', onClose);
+        try {
+            // Ignore backpressure return value — the callback + `'close'` listener
+            // + `isSocketGone` pre-check cover every settle path we need.
+            const ok = res.write(chunk, (err) => {
+                settle(err ?? null);
+            });
+            void ok;
+        }
+        catch (err) {
+            settle(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+/** Commit to SSE mode — call immediately after `beginSSE(res)` so the outer catch routes SSE-shaped failures correctly. */
+export function markSSEMode(visibility) {
+    visibility.responseMode = 'sse';
+}
+/** Best-effort synchronous SSE `error` event for the outer catch when the handler threw before flushing a terminal. */
+export function writeFallbackErrorSSE(res, eventType, data) {
+    try {
+        writeSSEEvent(res, eventType, data);
+    }
+    catch {
+        // Socket is gone — let the caller complete the lifecycle via `end` / destroy.
+    }
+}

package/dist/types-anthropic.d.ts

@@ -0,0 +1,144 @@
+/** Anthropic Messages API types: request/response shapes and SSE streaming events for POST /v1/messages. */
+export interface AnthropicTextContentBlock {
+    type: 'text';
+    text: string;
+}
+export interface AnthropicImageContentBlock {
+    type: 'image';
+    source: {
+        type: 'base64';
+        media_type: string;
+        data: string;
+    };
+}
+export interface AnthropicToolResultContentBlock {
+    type: 'tool_result';
+    tool_use_id: string;
+    /** May be a string, text-block array, or mix of text and image blocks. Image-mixed shapes are rejected by the mapper; see `resolveToolResultContent`. */
+    content?: string | (AnthropicTextContentBlock | AnthropicImageContentBlock)[];
+    is_error?: boolean;
+}
+export interface AnthropicToolUseContentBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface AnthropicThinkingContentBlock {
+    type: 'thinking';
+    thinking: string;
+}
+export type AnthropicContentBlock = AnthropicTextContentBlock | AnthropicImageContentBlock | AnthropicToolResultContentBlock | AnthropicToolUseContentBlock | AnthropicThinkingContentBlock;
+export interface SystemBlock {
+    type: 'text';
+    text: string;
+    cache_control?: {
+        type: string;
+    };
+}
+export interface AnthropicMessage {
+    role: 'user' | 'assistant';
+    content: string | AnthropicContentBlock[];
+}
+export interface AnthropicToolDefinition {
+    name: string;
+    description?: string;
+    input_schema: Record<string, unknown>;
+}
+export interface AnthropicToolChoice {
+    type: 'auto' | 'any' | 'tool';
+    name?: string;
+    disable_parallel_tool_use?: boolean;
+}
+export interface AnthropicMessagesRequest {
+    model: string;
+    messages: AnthropicMessage[];
+    max_tokens: number;
+    system?: string | SystemBlock[];
+    temperature?: number;
+    top_p?: number;
+    top_k?: number;
+    tools?: AnthropicToolDefinition[];
+    tool_choice?: AnthropicToolChoice;
+    stream?: boolean;
+    stop_sequences?: string[];
+    metadata?: {
+        user_id?: string;
+    };
+}
+export interface AnthropicResponseTextBlock {
+    type: 'text';
+    text: string;
+}
+export interface AnthropicResponseThinkingBlock {
+    type: 'thinking';
+    thinking: string;
+}
+export interface AnthropicResponseToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export type AnthropicResponseContent = AnthropicResponseTextBlock | AnthropicResponseThinkingBlock | AnthropicResponseToolUseBlock;
+export interface AnthropicUsage {
+    input_tokens: number;
+    output_tokens: number;
+}
+export interface AnthropicMessagesResponse {
+    id: string;
+    type: 'message';
+    role: 'assistant';
+    model: string;
+    content: AnthropicResponseContent[];
+    stop_reason: 'end_turn' | 'max_tokens' | 'stop_sequence' | 'tool_use' | null;
+    stop_sequence: string | null;
+    usage: AnthropicUsage;
+}
+export interface AnthropicTextDelta {
+    type: 'text_delta';
+    text: string;
+}
+export interface AnthropicThinkingDelta {
+    type: 'thinking_delta';
+    thinking: string;
+}
+export interface AnthropicInputJsonDelta {
+    type: 'input_json_delta';
+    partial_json: string;
+}
+export type AnthropicDelta = AnthropicTextDelta | AnthropicThinkingDelta | AnthropicInputJsonDelta;
+export interface AnthropicMessageStartEvent {
+    type: 'message_start';
+    message: AnthropicMessagesResponse;
+}
+export interface AnthropicContentBlockStartEvent {
+    type: 'content_block_start';
+    index: number;
+    content_block: AnthropicResponseContent;
+}
+export interface AnthropicContentBlockDeltaEvent {
+    type: 'content_block_delta';
+    index: number;
+    delta: AnthropicDelta;
+}
+export interface AnthropicContentBlockStopEvent {
+    type: 'content_block_stop';
+    index: number;
+}
+export interface AnthropicMessageDeltaEvent {
+    type: 'message_delta';
+    delta: {
+        stop_reason: string | null;
+        stop_sequence: string | null;
+    };
+    usage: {
+        input_tokens?: number;
+        output_tokens: number;
+    };
+}
+export interface AnthropicMessageStopEvent {
+    type: 'message_stop';
+}
+export type AnthropicStreamEvent = AnthropicMessageStartEvent | AnthropicContentBlockStartEvent | AnthropicContentBlockDeltaEvent | AnthropicContentBlockStopEvent | AnthropicMessageDeltaEvent | AnthropicMessageStopEvent;
+//# sourceMappingURL=types-anthropic.d.ts.map

package/dist/types-anthropic.d.ts.map

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

package/dist/types-anthropic.js

@@ -0,0 +1,2 @@
+/** Anthropic Messages API types: request/response shapes and SSE streaming events for POST /v1/messages. */
+export {};

package/dist/types.d.ts

@@ -0,0 +1,220 @@
+/** OpenAI Responses API types: request/response shapes and SSE streaming events for POST /v1/responses. */
+export interface InputTextPart {
+    type: 'input_text';
+    text: string;
+}
+export type ContentPart = InputTextPart;
+export interface InputMessage {
+    type?: 'message';
+    role: 'user' | 'assistant' | 'system' | 'developer';
+    content: string | ContentPart[];
+}
+export interface InputFunctionCall {
+    type: 'function_call';
+    id: string;
+    call_id: string;
+    name: string;
+    arguments: string;
+}
+export interface InputFunctionCallOutput {
+    type: 'function_call_output';
+    call_id: string;
+    output: string;
+}
+export type InputItem = InputMessage | InputFunctionCall | InputFunctionCallOutput;
+export interface ResponsesToolDefinition {
+    type: 'function';
+    name: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+    strict?: boolean;
+}
+export interface ResponsesAPIRequest {
+    model: string;
+    input: string | InputItem[];
+    instructions?: string;
+    tools?: ResponsesToolDefinition[];
+    tool_choice?: 'auto' | 'required' | 'none' | {
+        type: 'function';
+        name: string;
+    };
+    stream?: boolean;
+    temperature?: number;
+    top_p?: number;
+    max_output_tokens?: number;
+    reasoning?: {
+        effort?: string;
+        summary?: string;
+    };
+    previous_response_id?: string;
+    store?: boolean;
+    /**
+     * OpenAI-reserved `metadata` slot, repurposed here to carry MLX-Node
+     * extensions. Today this only exposes `retention_seconds` as a
+     * per-request override of `ServerConfig.responseRetentionSec`;
+     * unrelated keys are accepted and ignored (additive, forward-compat).
+     */
+    metadata?: {
+        /**
+         * Per-request retention override for the stored response row, in
+         * seconds. Must be a finite positive integer in `[60, 90 * 86400]`
+         * (1 minute … 90 days). Out-of-range or non-integer values return
+         * 400. When omitted, the server-wide default applies.
+         */
+        retention_seconds?: number;
+    };
+}
+export interface OutputTextPart {
+    type: 'output_text';
+    text: string;
+    annotations: never[];
+}
+export interface SummaryTextPart {
+    type: 'summary_text';
+    text: string;
+}
+export interface MessageOutputItem {
+    id: string;
+    type: 'message';
+    role: 'assistant';
+    status: 'completed' | 'incomplete' | 'in_progress';
+    content: OutputTextPart[];
+}
+export interface ReasoningOutputItem {
+    id: string;
+    type: 'reasoning';
+    summary: SummaryTextPart[];
+}
+export interface FunctionCallOutputItem {
+    id: string;
+    type: 'function_call';
+    call_id: string;
+    name: string;
+    arguments: string;
+    status: 'completed' | 'incomplete';
+}
+export type OutputItem = MessageOutputItem | ReasoningOutputItem | FunctionCallOutputItem;
+export interface ResponseUsage {
+    input_tokens: number;
+    output_tokens: number;
+    output_tokens_details: {
+        reasoning_tokens: number;
+    };
+    total_tokens: number;
+}
+export interface ResponseError {
+    type: string;
+    message: string;
+    code: string | null;
+    param: string | null;
+}
+export interface ResponseObject {
+    id: string;
+    object: 'response';
+    created_at: number;
+    status: 'completed' | 'incomplete' | 'in_progress' | 'failed';
+    model: string;
+    output: OutputItem[];
+    output_text: string;
+    error: ResponseError | null;
+    incomplete_details: {
+        reason: string;
+    } | null;
+    usage: ResponseUsage;
+    instructions: string | null;
+    temperature: number | null;
+    top_p: number | null;
+    max_output_tokens: number | null;
+    tools: ResponsesToolDefinition[];
+    tool_choice: 'auto' | 'required' | 'none' | {
+        type: 'function';
+        name: string;
+    } | null;
+    reasoning: {
+        effort?: string;
+        summary?: string;
+    } | null;
+    previous_response_id: string | null;
+}
+export interface ResponseCreatedEvent {
+    type: 'response.created';
+    response: ResponseObject;
+}
+export interface ResponseInProgressEvent {
+    type: 'response.in_progress';
+    response: ResponseObject;
+}
+export interface ResponseCompletedEvent {
+    type: 'response.completed';
+    response: ResponseObject;
+}
+export interface ResponseFailedEvent {
+    type: 'response.failed';
+    response: ResponseObject;
+}
+export interface OutputItemAddedEvent {
+    type: 'response.output_item.added';
+    output_index: number;
+    item: OutputItem;
+}
+export interface OutputItemDoneEvent {
+    type: 'response.output_item.done';
+    output_index: number;
+    item: OutputItem;
+}
+export interface ContentPartAddedEvent {
+    type: 'response.content_part.added';
+    item_id: string;
+    output_index: number;
+    content_index: number;
+    part: OutputTextPart;
+}
+export interface ContentPartDoneEvent {
+    type: 'response.content_part.done';
+    item_id: string;
+    output_index: number;
+    content_index: number;
+    part: OutputTextPart;
+}
+export interface OutputTextDeltaEvent {
+    type: 'response.output_text.delta';
+    item_id: string;
+    output_index: number;
+    content_index: number;
+    delta: string;
+}
+export interface OutputTextDoneEvent {
+    type: 'response.output_text.done';
+    item_id: string;
+    output_index: number;
+    content_index: number;
+    text: string;
+}
+export interface ReasoningSummaryTextDeltaEvent {
+    type: 'response.reasoning_summary_text.delta';
+    item_id: string;
+    output_index: number;
+    summary_index: number;
+    delta: string;
+}
+export interface ReasoningSummaryTextDoneEvent {
+    type: 'response.reasoning_summary_text.done';
+    item_id: string;
+    output_index: number;
+    summary_index: number;
+    text: string;
+}
+export interface FunctionCallArgumentsDeltaEvent {
+    type: 'response.function_call_arguments.delta';
+    item_id: string;
+    output_index: number;
+    delta: string;
+}
+export interface FunctionCallArgumentsDoneEvent {
+    type: 'response.function_call_arguments.done';
+    item_id: string;
+    output_index: number;
+    arguments: string;
+}
+export type StreamEvent = ResponseCreatedEvent | ResponseInProgressEvent | ResponseCompletedEvent | ResponseFailedEvent | OutputItemAddedEvent | OutputItemDoneEvent | ContentPartAddedEvent | ContentPartDoneEvent | OutputTextDeltaEvent | OutputTextDoneEvent | ReasoningSummaryTextDeltaEvent | ReasoningSummaryTextDoneEvent | FunctionCallArgumentsDeltaEvent | FunctionCallArgumentsDoneEvent;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+/** OpenAI Responses API types: request/response shapes and SSE streaming events for POST /v1/responses. */
+export {};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@mlx-node/server",
+  "version": "0.0.0",
+  "homepage": "https://github.com/mlx-node/mlx-node",
+  "bugs": {
+    "url": "https://github.com/mlx-node/mlx-node/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mlx-node/mlx-node.git",
+    "directory": "packages/server"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@mlx-node/core": "workspace:*",
+    "@mlx-node/lm": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:"
+  }
+}