lemon-model 1.2.3 → 1.2.4

package/dist/proxy/proxy.d.ts

@@ -1,75 +0,0 @@
-/**
- * `proxy/proxy.ts`
- * - HTTP-backed Gemini-compatible GenAI adapter.
- * - works in browser and Node by relying only on the standard `fetch` API.
- * - in transport mode HTTP only triggers generation; the final response is
- *   collected from a configured `ProxyTransportReceiver` (e.g. over WebSocket).
- *
- * @author      Claire <claude@lemoncloud.io>
- * @date        2026-06-08 initial version
- *
- * @copyright (C) lemoncloud.io 2026 - All Rights Reserved.
- */
-import { ProxyGenAI, ProxyGenAIGenerateContentParams, ProxyGenAIGenerateContentResponse, ProxyTransportReceiver } from './types';
-/** transport query mode for `HttpAbstractGenAI` endpoints. */
-export declare type HttpAbstractGenAITransportQuery = 'transportId' | 'flows';
-/** override names for transport query keys (avoid hard-coding). */
-export interface HttpAbstractGenAITransportQueryKeys {
-    /** flows connection-id key, default `connection` */
-    connection?: string;
-    /** flows transport-flag key, default `transport` (value `1`) */
-    transport?: string;
-    /** legacy transport-id key, default `transportId` */
-    transportId?: string;
-}
-/** options for wiring `HttpAbstractGenAI` to an agents/flows generate endpoint */
-export interface HttpAbstractGenAIOptions {
-    /** extra HTTP request headers */
-    headers?: Record<string, string>;
-    /** fetch override for tests, browsers, or custom runtimes */
-    fetch?: typeof fetch;
-    /** optional WebSocket/API Gateway transport connection id */
-    transportId?: string;
-    /** receiver used when the final response is delivered through JSONTransport */
-    transport?: ProxyTransportReceiver;
-    /** transport query mode; default `transportId` keeps the original behavior */
-    transportQuery?: HttpAbstractGenAITransportQuery;
-    /** override transport query key names */
-    transportQueryKeys?: HttpAbstractGenAITransportQueryKeys;
-    /** fully custom transport endpoint builder; takes precedence over `transportQuery` */
-    asTransportEndpoint?: (endpoint: string, transportId: string) => string;
-}
-export declare const $gemini: {
-    /**
-     * Convert common agents/flows `GenAIResponse` shapes back into a Gemini-like
-     * `models.generateContent()` response shape.
-     * - data URL image output is restored to `candidates[0].content.parts[0].inlineData`.
-     * - text output is restored to `text` and a text part.
-     * - usage/cost and `$run`/`usageId`/`model` records are preserved when present.
-     */
-    asGenerateContentResponse(data: any): ProxyGenAIGenerateContentResponse;
-};
-/** HTTP-backed Gemini-compatible GenAI adapter. */
-export declare class HttpAbstractGenAI implements ProxyGenAI {
-    protected readonly endpoint: string;
-    /** captured raw generateContent params, useful in specs and diagnostics */
-    calls: ProxyGenAIGenerateContentParams[];
-    private readonly fetcher?;
-    private readonly headers;
-    private readonly transportId?;
-    private readonly transport?;
-    private readonly transportQuery;
-    private readonly transportQueryKeys;
-    private readonly asTransportEndpointFn?;
-    constructor(endpoint: string, options?: HttpAbstractGenAIOptions);
-    readonly models: {
-        generateContent: (params: ProxyGenAIGenerateContentParams) => Promise<ProxyGenAIGenerateContentResponse>;
-    };
-    private waitTransport;
-    protected asEndpoint(): string;
-    private asAgentGenerateBody;
-    private withoutSystemInstruction;
-    private asPrompt;
-    private isImageRequest;
-    private hasInlineData;
-}

package/dist/proxy/proxy.js

@@ -1,198 +0,0 @@
-"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());
-    });
-};
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpAbstractGenAI = exports.$gemini = void 0;
-const asDataUrl = (data) => {
-    const matched = data.match(/^data:(.*?);base64,(.*)$/);
-    return matched ? { mimeType: matched[1] || 'image/png', data: matched[2] || '' } : undefined;
-};
-const onlyDefined = (data) => {
-    const out = {};
-    for (const key of Object.keys(data)) {
-        if (data[key] !== undefined)
-            out[key] = data[key];
-    }
-    return out;
-};
-const callFetch = (fetcher, input, init) => fetcher.call(globalThis, input, init);
-/** map both `promptToken/...` and `inputTokenCount/...` usage shapes into Gemini usageMetadata. */
-const asUsageMetadata = (usage) => {
-    var _a, _b, _c;
-    if (!usage || typeof usage !== 'object')
-        return undefined;
-    const usageMetadata = onlyDefined({
-        promptTokenCount: (_a = usage.promptToken) !== null && _a !== void 0 ? _a : usage.inputTokenCount,
-        thoughtsTokenCount: (_b = usage.completionToken) !== null && _b !== void 0 ? _b : usage.outputTokenCount,
-        totalTokenCount: (_c = usage.totalToken) !== null && _c !== void 0 ? _c : usage.totalTokenCount,
-    });
-    return Object.keys(usageMetadata).length > 0 ? usageMetadata : undefined;
-};
-exports.$gemini = {
-    /**
-     * Convert common agents/flows `GenAIResponse` shapes back into a Gemini-like
-     * `models.generateContent()` response shape.
-     * - data URL image output is restored to `candidates[0].content.parts[0].inlineData`.
-     * - text output is restored to `text` and a text part.
-     * - usage/cost and `$run`/`usageId`/`model` records are preserved when present.
-     */
-    asGenerateContentResponse(data) {
-        var _a, _b;
-        const content = (_a = data === null || data === void 0 ? void 0 : data.output) === null || _a === void 0 ? void 0 : _a.content;
-        const dataUrl = content && typeof content === 'object' ? content === null || content === void 0 ? void 0 : content.data : undefined;
-        const matched = typeof dataUrl === 'string' ? asDataUrl(dataUrl) : undefined;
-        const text = typeof content === 'string' ? content : typeof dataUrl === 'string' && !matched ? dataUrl : '';
-        const candidate = (_b = data === null || data === void 0 ? void 0 : data.candidate) !== null && _b !== void 0 ? _b : (matched
-            ? {
-                content: {
-                    parts: [
-                        {
-                            inlineData: {
-                                mimeType: matched.mimeType,
-                                data: matched.data,
-                            },
-                        },
-                    ],
-                },
-            }
-            : text
-                ? {
-                    content: {
-                        parts: [{ text }],
-                    },
-                }
-                : undefined);
-        return onlyDefined({
-            text,
-            candidates: candidate ? [candidate] : undefined,
-            usageMetadata: asUsageMetadata(data === null || data === void 0 ? void 0 : data.usage),
-            $run: data === null || data === void 0 ? void 0 : data.$run,
-            usageId: data === null || data === void 0 ? void 0 : data.usageId,
-            model: data === null || data === void 0 ? void 0 : data.model,
-            cost: data === null || data === void 0 ? void 0 : data.cost,
-        });
-    },
-};
-/** HTTP-backed Gemini-compatible GenAI adapter. */
-class HttpAbstractGenAI {
-    constructor(endpoint, options = {}) {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
-        this.endpoint = endpoint;
-        /** captured raw generateContent params, useful in specs and diagnostics */
-        this.calls = [];
-        this.models = {
-            generateContent: (params) => __awaiter(this, void 0, void 0, function* () {
-                this.calls.push(params);
-                const task = () => __awaiter(this, void 0, void 0, function* () {
-                    var _j;
-                    const fetcher = (_j = this.fetcher) !== null && _j !== void 0 ? _j : globalThis.fetch;
-                    if (typeof fetcher !== 'function') {
-                        throw new Error(`@fetch is required (no global fetch available) - HttpAbstractGenAI`);
-                    }
-                    const response = yield callFetch(fetcher, this.asEndpoint(), {
-                        method: 'POST',
-                        headers: Object.assign({ 'content-type': 'application/json' }, this.headers),
-                        body: JSON.stringify(this.asAgentGenerateBody(params)),
-                    });
-                    if (!response.ok) {
-                        const text = yield response.text().catch(() => '');
-                        throw new Error(`HTTP ${response.status} ${response.statusText}`.trim() + (text ? ` - ${text}` : ''));
-                    }
-                    return response.json();
-                });
-                const data = this.transportId ? yield this.waitTransport(task) : yield task();
-                return exports.$gemini.asGenerateContentResponse(data);
-            }),
-        };
-        this.fetcher = options.fetch;
-        this.headers = (_a = options.headers) !== null && _a !== void 0 ? _a : {};
-        this.transportId = options.transportId;
-        this.transport = options.transport;
-        this.transportQuery = (_b = options.transportQuery) !== null && _b !== void 0 ? _b : 'transportId';
-        this.transportQueryKeys = {
-            connection: (_d = (_c = options.transportQueryKeys) === null || _c === void 0 ? void 0 : _c.connection) !== null && _d !== void 0 ? _d : 'connection',
-            transport: (_f = (_e = options.transportQueryKeys) === null || _e === void 0 ? void 0 : _e.transport) !== null && _f !== void 0 ? _f : 'transport',
-            transportId: (_h = (_g = options.transportQueryKeys) === null || _g === void 0 ? void 0 : _g.transportId) !== null && _h !== void 0 ? _h : 'transportId',
-        };
-        this.asTransportEndpointFn = options.asTransportEndpoint;
-    }
-    waitTransport(task) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!this.transport)
-                throw new Error(`@transport is required when transportId is set - HttpAbstractGenAI`);
-            return this.transport.wait(this.transportId, task);
-        });
-    }
-    asEndpoint() {
-        if (!this.transportId)
-            return this.endpoint;
-        if (this.asTransportEndpointFn)
-            return this.asTransportEndpointFn(this.endpoint, this.transportId);
-        const url = new URL(this.endpoint, 'http://localhost');
-        if (this.transportQuery === 'flows') {
-            url.searchParams.set(this.transportQueryKeys.connection, this.transportId);
-            url.searchParams.set(this.transportQueryKeys.transport, '1');
-        }
-        else {
-            url.searchParams.set(this.transportQueryKeys.transportId, this.transportId);
-        }
-        if (/^https?:\/\//.test(this.endpoint))
-            return url.toString();
-        return `${url.pathname}${url.search}${url.hash}`;
-    }
-    asAgentGenerateBody(params) {
-        var _a;
-        const config = this.withoutSystemInstruction(params.config);
-        const system = (_a = params.config) === null || _a === void 0 ? void 0 : _a.systemInstruction;
-        return {
-            model: params.model,
-            prompt: this.asPrompt(params.contents),
-            system,
-            image: this.isImageRequest(params),
-            config,
-        };
-    }
-    withoutSystemInstruction(config) {
-        if (!config)
-            return undefined;
-        const { systemInstruction } = config, rest = __rest(config, ["systemInstruction"]);
-        return Object.keys(rest).length > 0 ? rest : undefined;
-    }
-    asPrompt(contents) {
-        if (typeof contents === 'string')
-            return contents;
-        return { type: 'user', content: contents };
-    }
-    isImageRequest(params) {
-        var _a, _b;
-        const modalities = (_b = (_a = params.config) === null || _a === void 0 ? void 0 : _a.responseModalities) !== null && _b !== void 0 ? _b : [];
-        const hasImageModality = modalities.some(modality => `${modality}`.toUpperCase() === 'IMAGE');
-        const hasInlineImage = this.hasInlineData(params.contents);
-        const imageModel = params.model.includes('image') || params.model.includes('imagen');
-        return hasImageModality || hasInlineImage || imageModel ? true : undefined;
-    }
-    hasInlineData(contents) {
-        const list = Array.isArray(contents) ? contents : [contents];
-        return list.some(content => { var _a; return typeof content !== 'string' && ((_a = content.parts) === null || _a === void 0 ? void 0 : _a.some(part => !!part.inlineData)); });
-    }
-}
-exports.HttpAbstractGenAI = HttpAbstractGenAI;
-//# sourceMappingURL=proxy.js.map

package/dist/proxy/proxy.js.map

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

package/dist/proxy/transport.d.ts

@@ -1,123 +0,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.
- */
-import { JSONTransportOptions } from '../socket/transport';
-import { NetworkMessageHandler, NetworkSupportable, SocketErrorHandler, SocketNetworkOptions, SocketReadyState, SocketUnsubscribe } from '../socket/types';
-import { ProxyTransportReceiver } from './types';
-/** event map required from a browser-like WebSocket object */
-export interface WebSocketCompatibleEventMap {
-    open: unknown;
-    close: unknown;
-    error: unknown;
-    message: {
-        data: unknown;
-    };
-}
-/**
- * Minimal WebSocket-compatible contract.
- *
- * This keeps the proxy package usable in browsers, tests, and custom UI runtimes
- * without depending directly on the DOM `WebSocket` type.
- */
-export interface WebSocketCompatible {
-    readonly CONNECTING?: number;
-    readonly OPEN?: number;
-    readonly CLOSING?: number;
-    readonly CLOSED?: number;
-    readonly readyState: number;
-    send(data: string): void;
-    addEventListener<K extends keyof WebSocketCompatibleEventMap>(type: K, handler: (event: WebSocketCompatibleEventMap[K]) => void, options?: {
-        once?: boolean;
-    }): void;
-    removeEventListener<K extends keyof WebSocketCompatibleEventMap>(type: K, handler: (event: WebSocketCompatibleEventMap[K]) => void): void;
-}
-/** options for the standard WebSocket connection-id handshake */
-export interface WebSocketConnectionIdOptions {
-    /** message sent after socket open, usually `device.save` */
-    connectMessage?: string;
-    /** timeout for open and connection-id response */
-    timeoutMs?: number;
-    /** custom extractor when a service returns a different connection-id shape */
-    extract?: (message: unknown) => string | undefined;
-}
-/** options for receiving a single JSONTransport response */
-export interface ProxyTransportReceiverOptions<T extends object = object> {
-    timeoutMs?: number;
-    jsonTransport?: JSONTransportOptions;
-    validate?: (data: T) => boolean;
-    /**
-     * Unwrap a raw WebSocket message into a transport packet string.
-     * - by default the raw message is expected to be a transport packet directly.
-     * - set this when the gateway wraps frames, e.g. `{ body: "..." }` or `{ data: ... }`.
-     * - return `undefined` to ignore a non-transport message.
-     */
-    extractPacket?: (message: string) => string | undefined;
-}
-/** JSONTransport-backed receiver used by `HttpAbstractGenAI` transport mode */
-export declare class JSONProxyTransportReceiver<T extends object = object> implements ProxyTransportReceiver<T> {
-    private readonly network;
-    private readonly options;
-    private readonly transport;
-    private pending?;
-    constructor(network: NetworkSupportable, options?: ProxyTransportReceiverOptions<T>);
-    /**
-     * Run an HTTP trigger task and resolve with the next complete JSONTransport payload.
-     *
-     * Only one pending wait is supported per receiver instance.
-     */
-    wait(transportId: string, task: () => Promise<unknown>): Promise<T>;
-    /** detach listeners and reject an in-flight wait */
-    detach(): void;
-    private resolve;
-    private reject;
-}
-/** create a receiver that filters raw network packets down to JSONTransport frames */
-export declare const createProxyTransportReceiver: <T extends object = object>(network: NetworkSupportable, options?: ProxyTransportReceiverOptions<T>) => JSONProxyTransportReceiver<T>;
-/** extract a connection id from known API Gateway/WebSocket handshake response shapes */
-export declare const extractWebSocketConnectionId: (message: unknown) => string | undefined;
-/**
- * Wait until a WebSocket is open, send the handshake message, and resolve the
- * first connection id found in inbound messages.
- */
-export declare const waitWebSocketConnectionId: (ws: WebSocketCompatible, options?: WebSocketConnectionIdOptions) => Promise<string>;
-/**
- * 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.
- */
-export declare class BrowserWebSocketNetwork implements NetworkSupportable {
-    private readonly ws;
-    private readonly messageHandlers;
-    private readonly errorHandlers;
-    private readonly opened;
-    private readyOpenHandler?;
-    private readyErrorHandler?;
-    private detached;
-    private readonly handleOpen;
-    private readonly handleMessage;
-    private readonly handleError;
-    private readonly handleClose;
-    constructor(ws: WebSocketCompatible);
-    get readyState(): SocketReadyState;
-    ready(): Promise<void>;
-    send(data: string): void;
-    onMessage(handler: NetworkMessageHandler): SocketUnsubscribe;
-    configure(_options: SocketNetworkOptions): void;
-    onError(handler: SocketErrorHandler): SocketUnsubscribe;
-    close(): void;
-    /** remove all listeners without closing the externally owned WebSocket */
-    detach(): void;
-    private isOpen;
-    private stateValue;
-    private detachReadyListeners;
-}