lemon-model 1.1.0 → 1.2.0

package/dist/genai/proxy.d.ts

@@ -0,0 +1,65 @@
+/**
+ * `genai/proxy.ts`
+ * - HTTP-backed Gemini-compatible `AbstractGenAI` adapter.
+ * - works in server and browser runtimes by relying only on the standard `fetch` API.
+ *
+ * @origin eureka-agents-api / src/lib/proxy/proxy.ts
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+import { ProxyGenAI, ProxyGenAIConfig, ProxyGenAIContents, ProxyGenAIGenerateContentParams, ProxyGenAIGenerateContentResponse, ProxyTransportReceiver } from './types';
+/** options for wiring `HttpAbstractGenAI` to an agents 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;
+}
+interface AgentGenerateBody {
+    model: string;
+    prompt?: string | {
+        type?: string;
+        content: ProxyGenAIContents;
+    };
+    system?: string;
+    image?: boolean;
+    config?: ProxyGenAIConfig;
+}
+export declare const $gemini: {
+    /**
+     * Convert common agents `GenAIResponse` shapes back into Gemini-like
+     * `models.generateContent()` response shape.
+     */
+    asGenerateContentResponse(data: any): ProxyGenAIGenerateContentResponse;
+};
+/**
+ * HTTP-backed Gemini-compatible `AbstractGenAI` adapter.
+ *
+ * It works in server and browser runtimes by relying only on the standard `fetch` API.
+ * When `transportId` is configured, HTTP is used only to trigger generation and the
+ * final response is collected from the configured transport receiver.
+ */
+export declare class HttpAbstractGenAI implements ProxyGenAI {
+    protected readonly endpoint: string;
+    /** captured raw generateContent params, useful in specs and diagnostics */
+    calls: ProxyGenAIGenerateContentParams[];
+    protected readonly fetcher: typeof fetch;
+    protected readonly headers: Record<string, string>;
+    protected readonly transportId?: string;
+    protected readonly transport?: ProxyTransportReceiver;
+    constructor(endpoint: string, options?: HttpAbstractGenAIOptions);
+    readonly models: {
+        generateContent: (params: ProxyGenAIGenerateContentParams) => Promise<ProxyGenAIGenerateContentResponse>;
+    };
+    protected waitTransport(task: () => Promise<unknown>): Promise<object>;
+    protected asEndpoint(): string;
+    protected asAgentGenerateBody(params: ProxyGenAIGenerateContentParams): AgentGenerateBody;
+    protected withoutSystemInstruction(config?: ProxyGenAIConfig): ProxyGenAIConfig | undefined;
+    protected asPrompt(contents: ProxyGenAIContents): AgentGenerateBody['prompt'];
+    protected isImageRequest(params: ProxyGenAIGenerateContentParams): boolean | undefined;
+    private hasInlineData;
+}
+export {};

package/dist/genai/proxy.js

@@ -0,0 +1,165 @@
+"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) => Object.fromEntries(Object.entries(data).filter(([, value]) => value !== undefined));
+const callFetch = (fetcher, input, init) => fetcher.call(globalThis, input, init);
+exports.$gemini = {
+    /**
+     * Convert common agents `GenAIResponse` shapes back into Gemini-like
+     * `models.generateContent()` response shape.
+     */
+    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: (data === null || data === void 0 ? void 0 : data.usage)
+                ? onlyDefined({
+                    promptTokenCount: data.usage.promptToken,
+                    thoughtsTokenCount: data.usage.completionToken,
+                    totalTokenCount: data.usage.totalToken,
+                })
+                : undefined,
+        });
+    },
+};
+/**
+ * HTTP-backed Gemini-compatible `AbstractGenAI` adapter.
+ *
+ * It works in server and browser runtimes by relying only on the standard `fetch` API.
+ * When `transportId` is configured, HTTP is used only to trigger generation and the
+ * final response is collected from the configured transport receiver.
+ */
+class HttpAbstractGenAI {
+    constructor(endpoint, options = {}) {
+        var _a, _b;
+        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* () {
+                    const response = yield callFetch(this.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);
+            }),
+        };
+        //! NOTE: property access (not bare `fetch`) so runtimes w/o global fetch fail at call time, not construction.
+        this.fetcher = (_a = options.fetch) !== null && _a !== void 0 ? _a : globalThis.fetch;
+        this.headers = (_b = options.headers) !== null && _b !== void 0 ? _b : {};
+        this.transportId = options.transportId;
+        this.transport = options.transport;
+    }
+    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;
+        const url = new URL(this.endpoint, 'http://localhost');
+        url.searchParams.set('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/genai/proxy.js.map

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

package/dist/genai/testing.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `genai/testing.ts`
+ * - isolated entry for GenAI proxy test helpers (fetch routing + `/dump` contract mocks).
+ * - kept OUT of the package root barrel so production bundles do not include test helpers.
+ *
+ * Usage (tests / dev only):
+ *   import { createAgentGenerateFetcher, MockAgentGenerateController } from 'lemon-model/dist/genai/testing';
+ *
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+export * from './mocks';

package/dist/genai/testing.js

@@ -0,0 +1,28 @@
+"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 });
+/**
+ * `genai/testing.ts`
+ * - isolated entry for GenAI proxy test helpers (fetch routing + `/dump` contract mocks).
+ * - kept OUT of the package root barrel so production bundles do not include test helpers.
+ *
+ * Usage (tests / dev only):
+ *   import { createAgentGenerateFetcher, MockAgentGenerateController } from 'lemon-model/dist/genai/testing';
+ *
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+__exportStar(require("./mocks"), exports);
+//# sourceMappingURL=testing.js.map

package/dist/genai/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/genai/testing.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;GASG;AACH,0CAAwB"}

package/dist/genai/transport.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `genai/transport.ts`
+ * - JSONTransport-backed receiver for collecting GenAI generate results over `NetworkSupportable`.
+ * - the generic WebSocket → `NetworkSupportable` bridge lives in the shared socket core (`../socket/websocket`).
+ *
+ * @origin eureka-agents-api / src/lib/proxy/transport.ts (receiver parts; the WebSocket bridge was extracted into `../socket/websocket`)
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+import { JSONTransportOptions } from '../socket/transport';
+import { NetworkSupportable } from '../socket/types';
+import { ProxyTransportReceiver } from './types';
+/** options for receiving a single JSONTransport response */
+export interface ProxyTransportReceiverOptions<T extends object = object> {
+    timeoutMs?: number;
+    jsonTransport?: JSONTransportOptions;
+    validate?: (data: T) => boolean;
+}
+/** 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>;

package/dist/genai/transport.js

@@ -0,0 +1,136 @@
+"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.createProxyTransportReceiver = exports.JSONProxyTransportReceiver = void 0;
+/**
+ * `genai/transport.ts`
+ * - JSONTransport-backed receiver for collecting GenAI generate results over `NetworkSupportable`.
+ * - the generic WebSocket → `NetworkSupportable` bridge lives in the shared socket core (`../socket/websocket`).
+ *
+ * @origin eureka-agents-api / src/lib/proxy/transport.ts (receiver parts; the WebSocket bridge was extracted into `../socket/websocket`)
+ * @copyright (C) 2026 LemonCloud Co Ltd. - 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.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;
+/** network wrapper that lets JSONTransport see only transport packet strings */
+class TransportPacketNetwork {
+    constructor(source) {
+        this.source = source;
+    }
+    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 => {
+            if (!isTransportPacketString(data))
+                return;
+            handler(data);
+        });
+    }
+    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/genai/transport.js.map

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

package/dist/genai/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * `genai/types.ts`
+ * - Runtime-neutral Gemini-compatible GenAI proxy surface types for F/B usage.
+ *
+ * @origin eureka-agents-api / src/lib/proxy/types.ts
+ * @copyright (C) 2026 LemonCloud Co Ltd. - 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 generateContent response returned by the proxy */
+export interface ProxyGenAIGenerateContentResponse {
+    text?: string;
+    candidates?: ProxyGenAICandidate[];
+    usageMetadata?: {
+        promptTokenCount?: number;
+        thoughtsTokenCount?: number;
+        totalTokenCount?: number;
+    };
+}
+/** 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/genai/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * `genai/types.ts`
+ * - Runtime-neutral Gemini-compatible GenAI proxy surface types for F/B usage.
+ *
+ * @origin eureka-agents-api / src/lib/proxy/types.ts
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/genai/types.js.map

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

package/dist/index.d.ts

@@ -10,3 +10,5 @@
  */
 export * from './types';
 export * from './cores';
+export * from './socket';
+export * from './genai';

package/dist/index.js

@@ -26,4 +26,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
  */
 __exportStar(require("./types"), exports);
 __exportStar(require("./cores"), exports);
+__exportStar(require("./socket"), exports);
+__exportStar(require("./genai"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;GASG;AACH,0CAAwB;AACxB,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;GASG;AACH,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB;AACzB,0CAAwB"}

package/dist/proxy/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `index.ts`
+ * - main index for HTTP/WebSocket GenAI proxy adapters.
+ *
+ * @author      Claire <claude@lemoncloud.io>
+ * @date        2026-06-08 initial version
+ *
+ * @copyright (C) lemoncloud.io 2026 - All Rights Reserved.
+ */
+export * from './types';
+export * from './proxy';
+export * from './transport';

package/dist/proxy/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 });
+/**
+ * `index.ts`
+ * - main index for HTTP/WebSocket GenAI proxy adapters.
+ *
+ * @author      Claire <claude@lemoncloud.io>
+ * @date        2026-06-08 initial version
+ *
+ * @copyright (C) lemoncloud.io 2026 - All Rights Reserved.
+ */
+__exportStar(require("./types"), exports);
+__exportStar(require("./proxy"), exports);
+__exportStar(require("./transport"), exports);
+//# sourceMappingURL=index.js.map

package/dist/proxy/index.js.map

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