@prismshadow/mmsp 0.5.0

package/dist/streamItems.d.ts

@@ -0,0 +1,36 @@
+import { ContentItem, DeltaContentItem, EventContentItem } from "./types";
+/**
+ * Assembles the items of one stream from the deltas a client yields. Model output is serial, so
+ * the deltas of an item are contiguous and one item streams at a time: it is done when a delta of
+ * the next item arrives, or when the stream ends.
+ *
+ * A delta belongs to the next item when it carries another `fidelity.item_id`, is of another
+ * kind, or begins an item by itself (a call's name, an image, a vector). Otherwise it continues
+ * the item streaming now: a delta without an id does, and so do a call's arguments whatever id a
+ * gateway puts on them. Fidelity sent alone under the item's id is that item's, whatever kind
+ * carries it.
+ *
+ * Every delta goes out as it arrives, without its `item_id`. A done item is the item's first
+ * delta with the growing field replaced by the join of every delta's, plus the item's fidelity.
+ */
+export declare class StreamItems {
+    private readonly client;
+    private item;
+    constructor(client: string);
+    private protocolError;
+    /**
+     * One delta a client yielded. Returns what goes out: the done item of the item it ended, if
+     * any, then the delta itself.
+     */
+    delta(delta: DeltaContentItem): EventContentItem[];
+    /**
+     * The next item began, or the stream ended: returns the done item of the item streaming now,
+     * or nothing when no delta of it went out.
+     */
+    end(): ContentItem[];
+    /**
+     * Whether a delta begins the next item rather than continuing the one streaming now.
+     */
+    private begins;
+}
+//# sourceMappingURL=streamItems.d.ts.map

package/dist/streamItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamItems.d.ts","sourceRoot":"","sources":["../src/streamItems.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,SAAS,CAAC;AAwFjB;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;IAGV,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,IAAI,CAAqB;gBAEJ,MAAM,EAAE,MAAM;IAE3C,OAAO,CAAC,aAAa;IAIrB;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,EAAE;IA6DlD;;;OAGG;IACH,GAAG,IAAI,WAAW,EAAE;IAsBpB;;OAEG;IACH,OAAO,CAAC,MAAM;CAkBf"}

package/dist/streamItems.js

@@ -0,0 +1,183 @@
+"use strict";
+// Copyright 2025 Prism Shadow. and/or its affiliates
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamItems = void 0;
+const util_1 = require("util");
+const errors_1 = require("./errors");
+const KINDS = {
+    text: { field: "text", header: [], join: (chunks) => chunks.join("") },
+    thinking: {
+        field: "thinking",
+        header: [],
+        join: (chunks) => chunks.join(""),
+    },
+    tool_call: {
+        field: "arguments",
+        header: ["name", "tool_call_id"],
+        join: (chunks) => chunks.join(""),
+        parse: (joined, client, header) => (0, errors_1.parseToolCallArguments)(joined, client, header.name, header.tool_call_id),
+        // a call's name comes once, on its first delta
+        begins: (delta) => Boolean(delta.name),
+    },
+    // an image arrives whole, while audio streams in chunks
+    inline_data: {
+        field: "data",
+        header: [],
+        join: (chunks) => Buffer.concat(chunks),
+        begins: (delta) => delta.mime_type.startsWith("image/"),
+    },
+    inline_thinking: {
+        field: "data",
+        header: [],
+        join: (chunks) => Buffer.concat(chunks),
+        begins: () => true,
+    },
+    // one whole vector per delta, and an empty one still stands for the input it was made of
+    embedding: {
+        field: "embedding",
+        header: [],
+        join: (chunks) => chunks.flat(),
+        begins: () => true,
+        keepsEmpty: true,
+    },
+};
+/**
+ * Whether a delta carries no content: its growing field and header fields are empty.
+ */
+function isEmpty(kind, fields) {
+    return (!kind.keepsEmpty &&
+        fields[kind.field].length === 0 &&
+        kind.header.every((field) => !fields[field]));
+}
+/**
+ * Assembles the items of one stream from the deltas a client yields. Model output is serial, so
+ * the deltas of an item are contiguous and one item streams at a time: it is done when a delta of
+ * the next item arrives, or when the stream ends.
+ *
+ * A delta belongs to the next item when it carries another `fidelity.item_id`, is of another
+ * kind, or begins an item by itself (a call's name, an image, a vector). Otherwise it continues
+ * the item streaming now: a delta without an id does, and so do a call's arguments whatever id a
+ * gateway puts on them. Fidelity sent alone under the item's id is that item's, whatever kind
+ * carries it.
+ *
+ * Every delta goes out as it arrives, without its `item_id`. A done item is the item's first
+ * delta with the growing field replaced by the join of every delta's, plus the item's fidelity.
+ */
+class StreamItems {
+    constructor(client) {
+        this.client = client;
+        this.item = null;
+    }
+    protocolError(message) {
+        return new errors_1.StreamProtocolError({ client: this.client, message });
+    }
+    /**
+     * One delta a client yielded. Returns what goes out: the done item of the item it ended, if
+     * any, then the delta itself.
+     */
+    delta(delta) {
+        const kind = delta.type.slice(0, -".delta".length);
+        if (!delta.type.endsWith(".delta") || !(kind in KINDS)) {
+            throw this.protocolError(`a client yields deltas, not ${delta.type}`);
+        }
+        const { fidelity: carried, ...content } = delta;
+        const { item_id: itemId, ...rest } = carried ?? {};
+        let fidelity = Object.keys(rest).length > 0 ? rest : undefined;
+        let fields = content;
+        const out = [];
+        let item = this.item;
+        if (item?.first !== undefined &&
+            item.kind !== kind &&
+            itemId &&
+            itemId === item.id &&
+            fidelity !== undefined &&
+            isEmpty(KINDS[kind], fields)) {
+            // fidelity sent alone under the item's id is that item's, whatever kind carries it
+            const spec = KINDS[item.kind];
+            fields = { ...item.first, [spec.field]: spec.join([]) };
+        }
+        else if (item === null || this.begins(item, kind, itemId, fields)) {
+            out.push(...this.end());
+            item = this.item = { kind, chunks: [] };
+        }
+        item.id = item.id || itemId;
+        const name = item.id ? `item ${item.id}` : "an item";
+        if (fidelity !== undefined) {
+            if (item.fidelity === undefined) {
+                item.fidelity = fidelity;
+            }
+            else if ((0, util_1.isDeepStrictEqual)(item.fidelity, fidelity)) {
+                // repeated fidelity goes out once
+                fidelity = undefined;
+            }
+            else {
+                throw this.protocolError(`${name} carried two different fidelity payloads`);
+            }
+        }
+        const spec = KINDS[item.kind];
+        if (isEmpty(spec, fields) && fidelity === undefined) {
+            // carries nothing; the item is streaming all the same
+            return out;
+        }
+        if (item.first === undefined) {
+            if (!spec.header.every((field) => fields[field])) {
+                throw this.protocolError(`the first ${fields.type} of ${name} must carry the ${spec.header.join(" and the ")}`);
+            }
+            item.first = fields;
+        }
+        item.chunks.push(fields[spec.field]);
+        out.push((fidelity ? { ...fields, fidelity } : fields));
+        return out;
+    }
+    /**
+     * The next item began, or the stream ended: returns the done item of the item streaming now,
+     * or nothing when no delta of it went out.
+     */
+    end() {
+        const item = this.item;
+        this.item = null;
+        if (item === null || item.first === undefined) {
+            return [];
+        }
+        const spec = KINDS[item.kind];
+        const joined = spec.join(item.chunks);
+        const done = {
+            ...item.first,
+            type: `${item.kind}.done`,
+            [spec.field]: spec.parse
+                ? spec.parse(joined, this.client, item.first)
+                : joined,
+        };
+        if (item.fidelity !== undefined) {
+            done.fidelity = item.fidelity;
+        }
+        return [done];
+    }
+    /**
+     * Whether a delta begins the next item rather than continuing the one streaming now.
+     */
+    begins(item, kind, itemId, fields) {
+        const spec = KINDS[kind];
+        if (item.kind !== kind || spec.begins?.(fields)) {
+            return true;
+        }
+        // what cannot begin an item (a call's arguments) continues the one streaming now
+        return (spec.header.length === 0 &&
+            Boolean(itemId) &&
+            Boolean(item.id) &&
+            itemId !== item.id);
+    }
+}
+exports.StreamItems = StreamItems;

package/dist/types.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Thinking level for model reasoning.
+ */
+export declare enum ThinkingLevel {
+    NONE = "none",
+    LOW = "low",
+    MEDIUM = "medium",
+    HIGH = "high",
+    XHIGH = "xhigh",
+    MAX = "max"
+}
+/**
+ * Prompt cache configuration for Claude models.
+ */
+export declare enum PromptCaching {
+    ENABLE = "enable",
+    DISABLE = "disable",
+    ENHANCE = "enhance"
+}
+export type ToolChoice = ("auto" | "required" | "none") | string[];
+export type Role = "user" | "assistant";
+export type EventType = "delta" | "stop";
+export type FinishReason = "stop" | "length" | "tool_call" | "unknown";
+export type AspectRatio = "1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "9:16" | "16:9" | "21:9";
+export type ImageSize = "1K" | "2K";
+/**
+ * Arbitrary JSON-style payload of wire-fidelity data recorded by a client,
+ * such as thinking signatures, phase labels, or the upstream reasoning field
+ * name. Opaque to consumers: pass it back unchanged so a replay reproduces
+ * the original wire message.
+ */
+export type Fidelity = Record<string, any>;
+export interface TextDoneItem {
+    type: "text.done";
+    text: string;
+    fidelity?: Fidelity;
+}
+export interface ImageUrlDoneItem {
+    type: "image_url.done";
+    image_url: string;
+}
+export interface InlineDataDoneItem {
+    type: "inline_data.done";
+    data: Buffer;
+    mime_type: string;
+    fidelity?: Fidelity;
+}
+export interface ThinkingDoneItem {
+    type: "thinking.done";
+    thinking: string;
+    fidelity?: Fidelity;
+}
+export interface InlineThinkingDoneItem {
+    type: "inline_thinking.done";
+    data: Buffer;
+    mime_type: string;
+    fidelity?: Fidelity;
+}
+export interface ToolCallDoneItem {
+    type: "tool_call.done";
+    name: string;
+    arguments: Record<string, any>;
+    tool_call_id: string;
+    fidelity?: Fidelity;
+}
+export interface ToolResultDoneItem {
+    type: "tool_result.done";
+    text: string;
+    images?: string[];
+    tool_call_id: string;
+}
+export interface EmbeddingDoneItem {
+    type: "embedding.done";
+    embedding: number[];
+}
+export type ContentItem = TextDoneItem | ImageUrlDoneItem | InlineDataDoneItem | ThinkingDoneItem | InlineThinkingDoneItem | ToolCallDoneItem | ToolResultDoneItem | EmbeddingDoneItem;
+export interface TextDeltaItem {
+    type: "text.delta";
+    text: string;
+    fidelity?: Fidelity;
+}
+export interface InlineDataDeltaItem {
+    type: "inline_data.delta";
+    data: Buffer;
+    mime_type: string;
+    fidelity?: Fidelity;
+}
+export interface ThinkingDeltaItem {
+    type: "thinking.delta";
+    thinking: string;
+    fidelity?: Fidelity;
+}
+export interface InlineThinkingDeltaItem {
+    type: "inline_thinking.delta";
+    data: Buffer;
+    mime_type: string;
+    fidelity?: Fidelity;
+}
+export interface ToolCallDeltaItem {
+    type: "tool_call.delta";
+    name: string;
+    arguments: string;
+    tool_call_id: string;
+    fidelity?: Fidelity;
+}
+export interface EmbeddingDeltaItem {
+    type: "embedding.delta";
+    embedding: number[];
+}
+export type DeltaContentItem = TextDeltaItem | InlineDataDeltaItem | ThinkingDeltaItem | InlineThinkingDeltaItem | ToolCallDeltaItem | EmbeddingDeltaItem;
+export type EventContentItem = DeltaContentItem | ContentItem;
+/**
+ * Usage metadata for model response.
+ */
+export interface UsageMetadata {
+    cached_tokens: number | null;
+    prompt_tokens: number | null;
+    thoughts_tokens: number | null;
+    response_tokens: number | null;
+}
+/**
+ * Universal message format for LLM communication.
+ */
+export interface UniMessage {
+    role: Role;
+    content_items: ContentItem[];
+    usage_metadata?: UsageMetadata | null;
+    finish_reason?: FinishReason | null;
+    created_at?: number;
+}
+/**
+ * Universal event format for streaming responses: a "delta" event carries exactly one delta or
+ * done item and no usage or finish reason; the one "stop" event that ends every successful
+ * stream carries no items and both.
+ */
+export interface UniEvent {
+    role: Role;
+    event_type: EventType;
+    content_items: EventContentItem[];
+    usage_metadata: UsageMetadata | null;
+    finish_reason: FinishReason | null;
+    created_at?: number;
+}
+/**
+ * Available tool schema.
+ */
+export interface ToolSchema {
+    name: string;
+    description: string;
+    parameters?: Record<string, any>;
+}
+/**
+ * Image generation configuration for models that support image output.
+ */
+export interface ImageConfig {
+    aspect_ratio?: AspectRatio;
+    image_size?: ImageSize;
+}
+/**
+ * Speaker and voice assignment for TTS.
+ */
+export interface SpeakerConfig {
+    voice: string;
+    speaker?: string;
+}
+/**
+ * Embedding generation configuration.
+ */
+export interface EmbeddingConfig {
+    dimensions?: number;
+}
+/**
+ * Universal configuration format for LLM requests.
+ */
+export interface UniConfig {
+    max_tokens?: number;
+    temperature?: number;
+    tools?: ToolSchema[];
+    thinking_summary?: boolean;
+    thinking_level?: ThinkingLevel;
+    tool_choice?: ToolChoice;
+    system_prompt?: string;
+    prompt_caching?: PromptCaching;
+    fast_mode?: boolean;
+    image_config?: ImageConfig;
+    tts_config?: SpeakerConfig[];
+    embedding_config?: EmbeddingConfig;
+    trace_id?: string;
+}
+//# 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,37 @@
+"use strict";
+// Copyright 2025 Prism Shadow. and/or its affiliates
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptCaching = exports.ThinkingLevel = void 0;
+/**
+ * Thinking level for model reasoning.
+ */
+var ThinkingLevel;
+(function (ThinkingLevel) {
+    ThinkingLevel["NONE"] = "none";
+    ThinkingLevel["LOW"] = "low";
+    ThinkingLevel["MEDIUM"] = "medium";
+    ThinkingLevel["HIGH"] = "high";
+    ThinkingLevel["XHIGH"] = "xhigh";
+    ThinkingLevel["MAX"] = "max";
+})(ThinkingLevel || (exports.ThinkingLevel = ThinkingLevel = {}));
+/**
+ * Prompt cache configuration for Claude models.
+ */
+var PromptCaching;
+(function (PromptCaching) {
+    PromptCaching["ENABLE"] = "enable";
+    PromptCaching["DISABLE"] = "disable";
+    PromptCaching["ENHANCE"] = "enhance";
+})(PromptCaching || (exports.PromptCaching = PromptCaching = {}));

package/dist/utils.d.ts

@@ -0,0 +1,99 @@
+import { UsageMetadata } from "./types";
+/**
+ * Fix the usage metadata for OpenRouter.
+ *
+ * OpenRouter occasionally does not include the reasoning tokens to the completion tokens.
+ *
+ * @param usageMetadata - The usage metadata.
+ * @param baseUrl - The API URL.
+ * @returns The fixed usage metadata.
+ */
+export declare function fixOpenrouterUsageMetadata(usageMetadata: UsageMetadata, baseUrl: string): UsageMetadata;
+/**
+ * Whether MMSP_DEBUG asks the clients to fail loudly on output they do not recognize.
+ *
+ * Streaming clients skip an unrecognized event so that a gateway's own frames cannot
+ * kill a long generation. The same silence hides a genuinely new provider event, so the
+ * guards stay one environment variable away.
+ *
+ * @returns Whether debug mode is on.
+ */
+/**
+ * The key and the endpoint of a client that reads the environment's OPENAI_API_KEY or
+ * ANTHROPIC_API_KEY. A key passed in is used as it is. Without one, the environment's key goes
+ * out only to the endpoint the environment names: a base URL passed in is another endpoint,
+ * which that key was not given for, so it needs a key of its own.
+ *
+ * @param client - The client's class name, for the error
+ * @param options - The key and the base URL passed to the client
+ * @param env - The environment variables that hold the key and the base URL
+ * @returns The key and the base URL to build the SDK client with, either of which may be undefined
+ */
+export declare function resolveCredentials(client: string, options: {
+    apiKey?: string;
+    baseUrl?: string | null;
+}, env: {
+    key: string;
+    baseUrl: string;
+}): {
+    apiKey: string | undefined;
+    baseUrl: string | undefined;
+};
+export declare function isDebugEnabled(): boolean;
+/** Pixel dimensions read from an image header. */
+export interface ImageDimensions {
+    width: number;
+    height: number;
+}
+/**
+ * Read the pixel dimensions from the header of a PNG, JPEG, GIF or WebP image.
+ *
+ * Only the header is inspected, so the bytes may be a prefix of the file; a
+ * prefix that ends before the dimensions are reached reads as unrecognized.
+ *
+ * @param bytes - The image bytes, or a prefix of them.
+ * @returns The dimensions, or null when the bytes are not a recognized image.
+ */
+export declare function imageDimensions(bytes: Buffer): ImageDimensions | null;
+/**
+ * Whether the OpenAI vision API would reject an image at `original` detail.
+ *
+ * The API covers an image with 32-pixel patches and rejects one that needs
+ * more than 30,000 of them after its own resizing; at `original` detail the
+ * only resizing is the 65,535-pixel cap on either side. Only a base64 data URL
+ * can be measured here: an HTTP(S) URL answers false. The Responses clients
+ * pass such a URL through for the API to fetch; the Chat client fetches it
+ * into a data URL first, so it measures the fetched bytes.
+ *
+ * @param imageUrl - The image URL.
+ * @returns Whether the API would reject the image.
+ */
+export declare function exceedsOpenaiPatchLimit(imageUrl: string): boolean;
+/**
+ * The `detail` an OpenAI image part needs so that the API reads the image.
+ *
+ * GPT-5.6 reads the default `auto` detail as `original`, which keeps the
+ * image's own dimensions and rejects one over 30,000 patches instead of
+ * resizing it; `high` has the API fit it into 2,500 patches, so the image is
+ * read instead of refused. Every other model keeps a patch budget at every
+ * detail level, so no other model gets the field.
+ *
+ * @param model - The model id the request is sent with.
+ * @param imageUrl - The image URL as it goes on the wire.
+ * @returns `"high"` when the image needs it, otherwise undefined.
+ */
+export declare function openaiImageDetail(model: string, imageUrl: string): "high" | undefined;
+/**
+ * Split a two-speaker TTS script into turns, for the TTS models that take each turn's speaker
+ * as metadata rather than as a label in the text.
+ *
+ * A line that starts with a configured speaker's name and a colon ("Joe: How's it going?")
+ * begins that speaker's turn; any other line continues the turn before it.
+ *
+ * @param text - The script, one "Name: line" per turn
+ * @param speakers - The speaker names the request configures
+ * @returns [speaker, text] per turn, in order
+ * @throws Error when the script does not begin with a speaker's label
+ */
+export declare function speakerTurns(text: string, speakers: string[]): [string, string][];
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,MAAM,GACd,aAAa,CAYf;AAED;;;;;;;;GAQG;AACH;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACrD,GAAG,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAgB7D;AAED,wBAAgB,cAAc,IAAI,OAAO,CAGxC;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAwGrE;AAgDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAgCjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAAE,GACjB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAgBpB"}