lemon-model 1.1.0 → 1.2.0

package/dist/proxy/transport.js

@@ -0,0 +1,401 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserWebSocketNetwork = exports.waitWebSocketConnectionId = exports.extractWebSocketConnectionId = exports.createProxyTransportReceiver = exports.JSONProxyTransportReceiver = void 0;
+/**
+ * `proxy/transport.ts`
+ * - browser/WebSocket helpers for receiving proxy generate results over JSONTransport.
+ * - depends on a minimal `WebSocketCompatible` contract, not the DOM `WebSocket` type,
+ *   so it stays usable in browsers, Node, and custom UI runtimes.
+ *
+ * @author      Claire <claude@lemoncloud.io>
+ * @date        2026-06-08 initial version
+ *
+ * @copyright (C) lemoncloud.io 2026 - All Rights Reserved.
+ */
+const transport_1 = require("../socket/transport");
+/** JSONTransport-backed receiver used by `HttpAbstractGenAI` transport mode */
+class JSONProxyTransportReceiver {
+    constructor(network, options = {}) {
+        this.network = network;
+        this.options = options;
+        this.transport = (0, transport_1.createJSONTransport)(new TransportPacketNetwork(network, options.extractPacket), options.jsonTransport);
+        this.transport.onMessage(data => this.resolve(data));
+        this.transport.onError(error => this.reject(error));
+    }
+    /**
+     * Run an HTTP trigger task and resolve with the next complete JSONTransport payload.
+     *
+     * Only one pending wait is supported per receiver instance.
+     */
+    wait(transportId, task) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.pending)
+                throw new Error(`@transport is already waiting - proxy.transport(${transportId})`);
+            if (!transportId)
+                throw new Error(`@transportId (string) is required - proxy.transport`);
+            const promise = new Promise((resolve, reject) => {
+                var _a;
+                const timeoutMs = (_a = this.options.timeoutMs) !== null && _a !== void 0 ? _a : 30000;
+                const timer = timeoutMs > 0
+                    ? setTimeout(() => {
+                        this.reject(new Error(`@transport[${transportId}] timeout - proxy.transport`));
+                    }, timeoutMs)
+                    : undefined;
+                this.pending = { transportId, resolve, reject, timer };
+            });
+            try {
+                yield task();
+            }
+            catch (e) {
+                this.reject(e);
+            }
+            return promise;
+        });
+    }
+    /** detach listeners and reject an in-flight wait */
+    detach() {
+        this.reject(new Error(`@transport detached - proxy.transport`));
+        this.transport.detach();
+    }
+    resolve(data) {
+        if (!this.pending)
+            return;
+        if (this.options.validate && !this.options.validate(data))
+            return;
+        const pending = this.pending;
+        this.pending = undefined;
+        if (pending.timer)
+            clearTimeout(pending.timer);
+        pending.resolve(data);
+    }
+    reject(error) {
+        if (!this.pending)
+            return;
+        const pending = this.pending;
+        this.pending = undefined;
+        if (pending.timer)
+            clearTimeout(pending.timer);
+        pending.reject(error);
+    }
+}
+exports.JSONProxyTransportReceiver = JSONProxyTransportReceiver;
+/** create a receiver that filters raw network packets down to JSONTransport frames */
+const createProxyTransportReceiver = (network, options) => new JSONProxyTransportReceiver(network, options);
+exports.createProxyTransportReceiver = createProxyTransportReceiver;
+/** extract a connection id from known API Gateway/WebSocket handshake response shapes */
+const extractWebSocketConnectionId = (message) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    if (!message || typeof message !== 'object')
+        return undefined;
+    const data = message;
+    const candidates = [
+        data.connectionId,
+        data.connId,
+        (_a = data.data) === null || _a === void 0 ? void 0 : _a.connectionId,
+        (_b = data.data) === null || _b === void 0 ? void 0 : _b.connId,
+        (_d = (_c = data.data) === null || _c === void 0 ? void 0 : _c.connId) === null || _d === void 0 ? void 0 : _d.id,
+        (_e = data.data) === null || _e === void 0 ? void 0 : _e.id,
+        (_f = data.body) === null || _f === void 0 ? void 0 : _f.connectionId,
+        (_g = data.body) === null || _g === void 0 ? void 0 : _g.connId,
+        (_h = data.body) === null || _h === void 0 ? void 0 : _h.id,
+        data.id,
+    ];
+    return candidates.find(value => typeof value === 'string' && value.length > 0);
+};
+exports.extractWebSocketConnectionId = extractWebSocketConnectionId;
+/**
+ * Wait until a WebSocket is open, send the handshake message, and resolve the
+ * first connection id found in inbound messages.
+ */
+const waitWebSocketConnectionId = (ws, options = {}) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const timeoutMs = (_a = options.timeoutMs) !== null && _a !== void 0 ? _a : 15000;
+    const extract = (_b = options.extract) !== null && _b !== void 0 ? _b : exports.extractWebSocketConnectionId;
+    yield waitWebSocketOpen(ws, timeoutMs);
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const timer = timeoutMs > 0
+            ? setTimeout(() => {
+                rejectOnce(new Error(`timeout waiting for connectionId from WebSocket: ${timeoutMs}ms`));
+            }, timeoutMs)
+            : undefined;
+        const cleanup = () => {
+            if (timer)
+                clearTimeout(timer);
+            ws.removeEventListener('message', onMessage);
+            ws.removeEventListener('error', onError);
+            ws.removeEventListener('close', onClose);
+        };
+        const resolveOnce = (connectionId) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve(connectionId);
+        };
+        const rejectOnce = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(error);
+        };
+        const onMessage = (event) => __awaiter(void 0, void 0, void 0, function* () {
+            try {
+                const raw = yield asWebSocketText(event.data);
+                const json = tryParseWebSocketJSON(raw);
+                const connectionId = extract(json !== null && json !== void 0 ? json : raw);
+                if (connectionId)
+                    resolveOnce(connectionId);
+            }
+            catch (e) {
+                rejectOnce(e);
+            }
+        });
+        const onError = (event) => rejectOnce(event);
+        const onClose = () => rejectOnce(new Error(`WebSocket closed before connectionId was received`));
+        ws.addEventListener('message', onMessage);
+        ws.addEventListener('error', onError, { once: true });
+        ws.addEventListener('close', onClose, { once: true });
+        if (options.connectMessage)
+            ws.send(options.connectMessage);
+    });
+});
+exports.waitWebSocketConnectionId = waitWebSocketConnectionId;
+/**
+ * Adapter from browser-like WebSocket objects to `NetworkSupportable`.
+ *
+ * The adapter does not own externally supplied WebSocket instances. `close()` is
+ * intentionally equivalent to `detach()`; callers that created the WebSocket should
+ * close it themselves when they want the underlying connection closed.
+ */
+class BrowserWebSocketNetwork {
+    constructor(ws) {
+        this.ws = ws;
+        this.messageHandlers = new Set();
+        this.errorHandlers = new Set();
+        this.detached = false;
+        this.handleOpen = () => undefined;
+        this.handleMessage = (event) => {
+            if (this.detached || typeof event.data !== 'string')
+                return;
+            for (const handler of [...this.messageHandlers])
+                handler(event.data);
+        };
+        this.handleError = (event) => {
+            if (this.detached)
+                return;
+            for (const handler of [...this.errorHandlers])
+                handler(event, { scope: 'browserWebSocket', network: this });
+        };
+        this.handleClose = (event) => {
+            if (this.detached)
+                return;
+            for (const handler of [...this.errorHandlers])
+                handler(event, { scope: 'browserWebSocket.close', network: this });
+        };
+        this.opened = this.isOpen()
+            ? Promise.resolve()
+            : new Promise((resolve, reject) => {
+                const onOpen = () => {
+                    this.detachReadyListeners();
+                    resolve();
+                };
+                const onError = (event) => {
+                    this.detachReadyListeners();
+                    reject(event);
+                };
+                this.readyOpenHandler = onOpen;
+                this.readyErrorHandler = onError;
+                ws.addEventListener('open', onOpen, { once: true });
+                ws.addEventListener('error', onError, { once: true });
+            });
+        ws.addEventListener('open', this.handleOpen);
+        ws.addEventListener('message', this.handleMessage);
+        ws.addEventListener('error', this.handleError);
+        ws.addEventListener('close', this.handleClose);
+    }
+    get readyState() {
+        if (this.detached)
+            return 'closed';
+        if (this.isOpen())
+            return 'open';
+        if (this.ws.readyState === this.stateValue('CLOSING', 2))
+            return 'closing';
+        if (this.ws.readyState === this.stateValue('CLOSED', 3))
+            return 'closed';
+        return 'connecting';
+    }
+    ready() {
+        if (this.detached)
+            return Promise.reject(new Error(`@network connection error: closed - browserWebSocket.ready`));
+        return this.opened;
+    }
+    send(data) {
+        if (this.detached || !this.isOpen()) {
+            throw new Error(`@network connection error: ${this.readyState} - browserWebSocket.send`);
+        }
+        this.ws.send(data);
+    }
+    onMessage(handler) {
+        if (this.detached)
+            throw new Error(`@network connection error: closed - browserWebSocket.onMessage`);
+        this.messageHandlers.add(handler);
+        return () => this.messageHandlers.delete(handler);
+    }
+    configure(_options) {
+        // Browser WebSocket transport options are controlled by the browser/runtime.
+    }
+    onError(handler) {
+        this.errorHandlers.add(handler);
+        return () => this.errorHandlers.delete(handler);
+    }
+    close() {
+        this.detach();
+    }
+    /** remove all listeners without closing the externally owned WebSocket */
+    detach() {
+        if (this.detached)
+            return;
+        this.detached = true;
+        this.messageHandlers.clear();
+        this.errorHandlers.clear();
+        this.ws.removeEventListener('open', this.handleOpen);
+        this.ws.removeEventListener('message', this.handleMessage);
+        this.ws.removeEventListener('error', this.handleError);
+        this.ws.removeEventListener('close', this.handleClose);
+        this.detachReadyListeners();
+    }
+    isOpen() {
+        return this.ws.readyState === this.stateValue('OPEN', 1);
+    }
+    stateValue(key, fallback) {
+        return typeof this.ws[key] === 'number' ? this.ws[key] : fallback;
+    }
+    detachReadyListeners() {
+        if (this.readyOpenHandler)
+            this.ws.removeEventListener('open', this.readyOpenHandler);
+        if (this.readyErrorHandler)
+            this.ws.removeEventListener('error', this.readyErrorHandler);
+        this.readyOpenHandler = undefined;
+        this.readyErrorHandler = undefined;
+    }
+}
+exports.BrowserWebSocketNetwork = BrowserWebSocketNetwork;
+const waitWebSocketOpen = (ws, timeoutMs) => {
+    if (ws.readyState === stateValue(ws, 'OPEN', 1))
+        return Promise.resolve();
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const timer = timeoutMs > 0
+            ? setTimeout(() => rejectOnce(new Error(`timeout waiting for WebSocket open: ${timeoutMs}ms`)), timeoutMs)
+            : undefined;
+        const cleanup = () => {
+            if (timer)
+                clearTimeout(timer);
+            ws.removeEventListener('open', onOpen);
+            ws.removeEventListener('error', onError);
+            ws.removeEventListener('close', onClose);
+        };
+        const resolveOnce = () => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve();
+        };
+        const rejectOnce = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(error);
+        };
+        const onOpen = () => resolveOnce();
+        const onError = (event) => rejectOnce(event);
+        const onClose = () => rejectOnce(new Error(`WebSocket closed before open`));
+        ws.addEventListener('open', onOpen, { once: true });
+        ws.addEventListener('error', onError, { once: true });
+        ws.addEventListener('close', onClose, { once: true });
+    });
+};
+const stateValue = (ws, key, fallback) => (typeof ws[key] === 'number' ? ws[key] : fallback);
+const asWebSocketText = (data) => __awaiter(void 0, void 0, void 0, function* () {
+    if (typeof data === 'string')
+        return data;
+    if (data instanceof ArrayBuffer)
+        return new TextDecoder().decode(data);
+    if (ArrayBuffer.isView(data))
+        return new TextDecoder().decode(data);
+    const readable = data;
+    if (typeof (readable === null || readable === void 0 ? void 0 : readable.text) === 'function')
+        return readable.text();
+    if (typeof (readable === null || readable === void 0 ? void 0 : readable.arrayBuffer) === 'function')
+        return new TextDecoder().decode(yield readable.arrayBuffer());
+    return String(data);
+});
+const tryParseWebSocketJSON = (text) => {
+    try {
+        return JSON.parse(text);
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
+/** network wrapper that lets JSONTransport see only transport packet strings */
+class TransportPacketNetwork {
+    constructor(source, extractPacket) {
+        this.source = source;
+        this.extractPacket = extractPacket;
+    }
+    get readyState() {
+        return this.source.readyState;
+    }
+    ready() {
+        var _a, _b, _c;
+        return (_c = (_b = (_a = this.source).ready) === null || _b === void 0 ? void 0 : _b.call(_a)) !== null && _c !== void 0 ? _c : Promise.resolve();
+    }
+    send(data) {
+        this.source.send(data);
+    }
+    onMessage(handler) {
+        return this.source.onMessage(data => {
+            const packet = this.extractPacket ? this.extractPacket(data) : data;
+            if (typeof packet !== 'string' || !isTransportPacketString(packet))
+                return;
+            handler(packet);
+        });
+    }
+    configure(options) {
+        var _a, _b;
+        (_b = (_a = this.source).configure) === null || _b === void 0 ? void 0 : _b.call(_a, options);
+    }
+    onError(handler) {
+        return this.source.onError(handler);
+    }
+    close() {
+        this.source.close();
+    }
+}
+const isTransportPacketString = (data) => {
+    try {
+        const packet = JSON.parse(data);
+        return ((packet === null || packet === void 0 ? void 0 : packet.type) === 'json:manifest' ||
+            (packet === null || packet === void 0 ? void 0 : packet.type) === 'json:chunk' ||
+            (packet === null || packet === void 0 ? void 0 : packet.type) === 'json:complete' ||
+            (packet === null || packet === void 0 ? void 0 : packet.type) === 'json:error');
+    }
+    catch (_a) {
+        return false;
+    }
+};
+//# sourceMappingURL=transport.js.map

package/dist/proxy/transport.js.map

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

package/dist/proxy/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * `proxy/types.ts`
+ * - runtime-neutral Gemini-compatible proxy surface types.
+ *
+ * @author      Claire <claude@lemoncloud.io>
+ * @date        2026-06-08 initial version
+ *
+ * @copyright (C) lemoncloud.io 2026 - All Rights Reserved.
+ */
+/** inline binary payload in Gemini-compatible content parts */
+export interface ProxyGenAIInlineData {
+    data: string;
+    mimeType?: string;
+}
+/** text or inline-data part for a Gemini-compatible content block */
+export interface ProxyGenAIPart {
+    text?: string;
+    inlineData?: ProxyGenAIInlineData;
+}
+/** Gemini-compatible content block */
+export interface ProxyGenAIContent {
+    role?: string;
+    parts: ProxyGenAIPart[];
+}
+/** accepted `contents` shapes for proxy generateContent calls */
+export declare type ProxyGenAIContents = string | ProxyGenAIContent | ProxyGenAIContent[];
+/** image generation config subset used by samples/proxy */
+export interface ProxyGenAIImageConfig {
+    aspectRatio?: string;
+    imageSize?: string;
+}
+/** generation config subset supported by `HttpAbstractGenAI` */
+export interface ProxyGenAIConfig {
+    systemInstruction?: string;
+    responseMimeType?: string;
+    responseSchema?: unknown;
+    responseModalities?: unknown[];
+    temperature?: number;
+    topP?: number;
+    imageConfig?: ProxyGenAIImageConfig;
+}
+/** Gemini-compatible generateContent params accepted by the proxy */
+export interface ProxyGenAIGenerateContentParams {
+    model: string;
+    contents: ProxyGenAIContents;
+    config?: ProxyGenAIConfig;
+}
+/** Gemini-compatible candidate response */
+export interface ProxyGenAICandidate {
+    content: {
+        parts: ProxyGenAIPart[];
+    };
+}
+/** Gemini-compatible token usage metadata */
+export interface ProxyGenAIUsageMetadata {
+    promptTokenCount?: number;
+    thoughtsTokenCount?: number;
+    totalTokenCount?: number;
+}
+/**
+ * Gemini-compatible generateContent response returned by the proxy.
+ * - extra flows/agents record fields (`$run`, `usageId`, `model`, `cost`, ...) are
+ *   preserved as additive passthroughs so callers can keep run/usage records.
+ */
+export interface ProxyGenAIGenerateContentResponse {
+    text?: string;
+    candidates?: ProxyGenAICandidate[];
+    usageMetadata?: ProxyGenAIUsageMetadata;
+    /** flows run record, preserved when present */
+    $run?: unknown;
+    /** usage record id, preserved when present */
+    usageId?: string;
+    /** resolved model name, preserved when present */
+    model?: string;
+    /** server-reported cost, preserved when present */
+    cost?: number;
+    /** allow additional flows fields to survive without breaking the typed surface */
+    [key: string]: unknown;
+}
+/** minimal GenAI interface implemented by `HttpAbstractGenAI` */
+export interface ProxyGenAI {
+    models: {
+        generateContent(params: ProxyGenAIGenerateContentParams): Promise<ProxyGenAIGenerateContentResponse>;
+    };
+}
+/** transport receiver used when HTTP only triggers work and the result arrives elsewhere */
+export interface ProxyTransportReceiver<T extends object = object> {
+    wait(transportId: string, task: () => Promise<unknown>): Promise<T>;
+}

package/dist/proxy/types.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * `proxy/types.ts`
+ * - runtime-neutral Gemini-compatible proxy surface types.
+ *
+ * @author      Claire <claude@lemoncloud.io>
+ * @date        2026-06-08 initial version
+ *
+ * @copyright (C) lemoncloud.io 2026 - All Rights Reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/proxy/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/proxy/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/dist/socket/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `socket/index.ts`
+ * - shared socket(network) + json-transport core for F/B usage.
+ *
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+export * from './types';
+export * from './transport';
+export * from './websocket';

package/dist/socket/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * `socket/index.ts`
+ * - shared socket(network) + json-transport core for F/B usage.
+ *
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+__exportStar(require("./types"), exports);
+__exportStar(require("./transport"), exports);
+__exportStar(require("./websocket"), exports);
+//! NOTE: the in-memory peer simulator (`./socket`) is intentionally NOT re-exported here.
+//! It is a test/dev utility — import it via the isolated `lemon-model/dist/socket/testing` entry
+//! so production (esp. frontend) bundles do not pull in the simulator runtime.
+//# sourceMappingURL=index.js.map

package/dist/socket/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/socket/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;GAKG;AACH,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B;AAE5B,0FAA0F;AAC1F,iGAAiG;AACjG,+EAA+E"}