lemon-model 1.1.1 → 1.2.1

package/dist/genai/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `genai/index.ts`
+ * - shared GenAI proxy adapter (Gemini-compatible surface over HTTP + JSONTransport) for F/B usage.
+ *
+ * @origin eureka-agents-api / src/lib/proxy/index.ts
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+export * from './types';
+export * from './proxy';
+export * from './transport';
+export * from './dump-test';

package/dist/genai/index.js

@@ -0,0 +1,31 @@
+"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/index.ts`
+ * - shared GenAI proxy adapter (Gemini-compatible surface over HTTP + JSONTransport) for F/B usage.
+ *
+ * @origin eureka-agents-api / src/lib/proxy/index.ts
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+__exportStar(require("./types"), exports);
+__exportStar(require("./proxy"), exports);
+__exportStar(require("./transport"), exports);
+__exportStar(require("./dump-test"), exports);
+//! NOTE: test helpers (`./mocks`) are intentionally NOT re-exported here.
+//! Import them via the isolated `lemon-model/genai/testing` entry so
+//! production (esp. frontend) bundles do not pull in test-only helpers.
+//# sourceMappingURL=index.js.map

package/dist/genai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/genai/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH,0CAAwB;AACxB,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B;AAE5B,0EAA0E;AAC1E,qEAAqE;AACrE,wEAAwE"}

package/dist/genai/mocks.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `genai/mocks.ts`
+ * - Test helpers for exercising `HttpAbstractGenAI` without a live agents API.
+ * - `createAgentGenerateFetcher()` routes fetch calls into a controller-like object, and
+ *   `MockAgentGenerateController` emulates the `/agents/!/generate` `/dump` + transport contract
+ *   that `eureka-agents-api`'s `AgentAPIController.doPostGenerate()` provides.
+ *
+ * @origin eureka-agents-api / src/lib/proxy/mocks.ts (+ `/dump` contract distilled from `AgentAPIController` for F/B-neutral tests)
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+/** minimal controller shape required by `createAgentGenerateFetcher()` */
+export interface AgentGenerateControllerLike {
+    doPostGenerate(id: string, param: unknown, body: unknown, ctx: unknown): Promise<unknown>;
+}
+/**
+ * Create a `fetch` implementation that routes `/agents/:id/generate` calls
+ * directly into a controller instance.
+ */
+export declare const createAgentGenerateFetcher: (api: AgentGenerateControllerLike, ctx: unknown) => typeof fetch;
+/** ack subset returned by a transport sender (see `ApiGatewayTransportSendResult` upstream) */
+export interface MockGenerateTransportResult {
+    result?: boolean;
+    packets?: number;
+    [key: string]: unknown;
+}
+/** hook used by `MockAgentGenerateController` to deliver the final payload over a transport */
+export declare type MockGenerateTransportSender = (transportId: string, payload: Record<string, any>) => Promise<MockGenerateTransportResult>;
+/** options for `MockAgentGenerateController` */
+export interface MockAgentGenerateControllerOptions {
+    /** sender invoked when the generate request carries a `transportId` query parameter */
+    sendTransport?: MockGenerateTransportSender;
+}
+/** build the `/dump` echo payload from an agents generate request body */
+export declare const asDumpedGenerateRequest: (body: any) => Record<string, any>;
+/**
+ * In-memory stand-in for `AgentAPIController.doPostGenerate()` covering the `/dump` contract:
+ * - without `transportId`, it answers the dumped request as `output.content` JSON.
+ * - with `transportId`, it delivers the payload via `sendTransport()` and answers a transport ack.
+ */
+export declare class MockAgentGenerateController implements AgentGenerateControllerLike {
+    private readonly options;
+    constructor(options?: MockAgentGenerateControllerOptions);
+    doPostGenerate(id: string, param: any, body: any, _ctx: unknown): Promise<unknown>;
+}

package/dist/genai/mocks.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * `genai/mocks.ts`
+ * - Test helpers for exercising `HttpAbstractGenAI` without a live agents API.
+ * - `createAgentGenerateFetcher()` routes fetch calls into a controller-like object, and
+ *   `MockAgentGenerateController` emulates the `/agents/!/generate` `/dump` + transport contract
+ *   that `eureka-agents-api`'s `AgentAPIController.doPostGenerate()` provides.
+ *
+ * @origin eureka-agents-api / src/lib/proxy/mocks.ts (+ `/dump` contract distilled from `AgentAPIController` for F/B-neutral tests)
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+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.MockAgentGenerateController = exports.asDumpedGenerateRequest = exports.createAgentGenerateFetcher = void 0;
+/**
+ * Create a `fetch` implementation that routes `/agents/:id/generate` calls
+ * directly into a controller instance.
+ */
+const createAgentGenerateFetcher = (api, ctx) => ((url, init) => __awaiter(void 0, void 0, void 0, function* () {
+    const href = typeof url === 'string' || url instanceof URL ? `${url}` : url.url;
+    const parsed = new URL(href, 'http://localhost');
+    const matched = parsed.pathname.match(/^\/agents\/(.+)\/generate$/);
+    if (!matched) {
+        return {
+            ok: false,
+            status: 404,
+            statusText: 'Not Found',
+            text: () => __awaiter(void 0, void 0, void 0, function* () { return `unsupported endpoint: ${parsed.pathname}`; }),
+        };
+    }
+    const body = (init === null || init === void 0 ? void 0 : init.body) ? JSON.parse(`${init.body}`) : {};
+    try {
+        const data = yield api.doPostGenerate(decodeURIComponent(matched[1]), Object.fromEntries(parsed.searchParams.entries()), body, ctx);
+        return {
+            ok: true,
+            status: 200,
+            statusText: 'OK',
+            json: () => __awaiter(void 0, void 0, void 0, function* () { return data; }),
+            text: () => __awaiter(void 0, void 0, void 0, function* () { return JSON.stringify(data); }),
+        };
+    }
+    catch (e) {
+        const text = e instanceof Error ? e.message : `${e}`;
+        return {
+            ok: false,
+            status: 500,
+            statusText: 'Internal Server Error',
+            text: () => __awaiter(void 0, void 0, void 0, function* () { return text; }),
+        };
+    }
+}));
+exports.createAgentGenerateFetcher = createAgentGenerateFetcher;
+const onlyDefined = (data) => Object.fromEntries(Object.entries(data).filter(([, value]) => value !== undefined));
+/** truncate inlineData payloads to 36 chars like the upstream `/dump` echo */
+const truncateInlineData = (contents) => {
+    if (!contents || typeof contents !== 'object')
+        return contents;
+    if (Array.isArray(contents))
+        return contents.map(truncateInlineData);
+    const parts = Array.isArray(contents.parts)
+        ? contents.parts.map((part) => {
+            var _a;
+            return ((_a = part === null || part === void 0 ? void 0 : part.inlineData) === null || _a === void 0 ? void 0 : _a.data)
+                ? Object.assign(Object.assign({}, part), { inlineData: Object.assign(Object.assign({}, part.inlineData), { data: `${part.inlineData.data}`.substring(0, 36) }) }) : part;
+        })
+        : undefined;
+    return parts ? Object.assign(Object.assign({}, contents), { parts }) : contents;
+};
+/** build the `/dump` echo payload from an agents generate request body */
+const asDumpedGenerateRequest = (body) => {
+    var _a;
+    const prompt = body === null || body === void 0 ? void 0 : body.prompt;
+    const contents = typeof prompt === 'string' ? prompt : truncateInlineData(prompt === null || prompt === void 0 ? void 0 : prompt.content);
+    const config0 = onlyDefined(Object.assign(Object.assign({}, ((_a = body === null || body === void 0 ? void 0 : body.config) !== null && _a !== void 0 ? _a : {})), { systemInstruction: body === null || body === void 0 ? void 0 : body.system }));
+    const config = Object.keys(config0).length > 0 ? config0 : undefined;
+    const $param = onlyDefined({
+        model: body === null || body === void 0 ? void 0 : body.model,
+        isImage: (body === null || body === void 0 ? void 0 : body.image) === true ? true : undefined,
+        config: body === null || body === void 0 ? void 0 : body.config,
+    });
+    return onlyDefined({ model: body === null || body === void 0 ? void 0 : body.model, contents, config, $param });
+};
+exports.asDumpedGenerateRequest = asDumpedGenerateRequest;
+/**
+ * In-memory stand-in for `AgentAPIController.doPostGenerate()` covering the `/dump` contract:
+ * - without `transportId`, it answers the dumped request as `output.content` JSON.
+ * - with `transportId`, it delivers the payload via `sendTransport()` and answers a transport ack.
+ */
+class MockAgentGenerateController {
+    constructor(options = {}) {
+        this.options = options;
+    }
+    doPostGenerate(id, param, body, _ctx) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!id)
+                throw new Error(`@id (string) is required - mocks.doPostGenerate`);
+            const model = body === null || body === void 0 ? void 0 : body.model;
+            const dumped = (0, exports.asDumpedGenerateRequest)(body);
+            const $final = { output: { content: JSON.stringify(dumped) }, model };
+            const transportId = typeof (param === null || param === void 0 ? void 0 : param.transportId) === 'string' ? param.transportId : '';
+            if (!transportId)
+                return $final;
+            const sender = this.options.sendTransport;
+            if (!sender)
+                throw new Error(`.sendTransport is required when transportId is set - MockAgentGenerateController`);
+            const transport = yield sender(transportId, $final);
+            return onlyDefined({
+                transport: true,
+                transportId,
+                sent: (_a = transport.result) !== null && _a !== void 0 ? _a : true,
+                packets: (_b = transport.packets) !== null && _b !== void 0 ? _b : 1,
+                model,
+            });
+        });
+    }
+}
+exports.MockAgentGenerateController = MockAgentGenerateController;
+//# sourceMappingURL=mocks.js.map

package/dist/genai/mocks.js.map

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

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/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/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>;