lemon-model 1.1.0 → 1.2.0

package/dist/cores/transformer.d.ts

@@ -59,7 +59,9 @@ export interface View {
      */
     error?: string;
     /**
-     * (optional) internal cores data
+     * (optional) internal cores modifier info.
+     * - present if `hasCores` is true in `modelAsView()`
+     * - or can be shown only if model has cores data.
      */
     readonly $?: Cores;
 }
@@ -127,6 +129,12 @@ export declare abstract class AbstractTransformer<MyModel extends Model, MyView
      * ex) `{ a:1, b: undefined }` -> `{ a:1 }`
      */
     onlyDefined: <T extends object>(N?: T) => T;
+    /**
+     * transform the cores data
+     * @param cores the cores data to transform
+     * @returns transformed cores data or null
+     */
+    asCore<T extends Cores>(cores?: T | null): T | null;
     /**
      * transform from model to view
      *

package/dist/cores/transformer.js

@@ -35,28 +35,43 @@ class AbstractTransformer {
                 }, {})
                 : null;
     }
+    /**
+     * transform the cores data
+     * @param cores the cores data to transform
+     * @returns transformed cores data or null
+     */
+    asCore(cores) {
+        if (!cores || typeof cores !== 'object')
+            return null;
+        const ret = {};
+        if (cores.sid !== undefined)
+            ret.sid = String(cores.sid);
+        if (cores.gid !== undefined)
+            ret.gid = String(cores.gid);
+        if (cores.uid !== undefined)
+            ret.uid = String(cores.uid);
+        return this.onlyDefined(ret);
+    }
     /**
      * transform from model to view
      *
      * @see Transformable.modelAsView
      */
     modelAsView(model, hasCores) {
+        var _a;
         if (!model || typeof model !== 'object')
             return null;
-        const view = {
+        const view = this.onlyDefined({
+            $: (_a = model === null || model === void 0 ? void 0 : model.$) !== null && _a !== void 0 ? _a : undefined,
             id: model.id,
             createdAt: model.createdAt,
             updatedAt: model.updatedAt,
             deletedAt: model.deletedAt,
-        };
+        });
         if (model.error)
             view.error = model.error;
         if (hasCores) {
-            const $ = this.onlyDefined({
-                sid: model.sid,
-                gid: model.gid,
-                uid: model.uid,
-            });
+            const $ = this.asCore(model);
             Object.assign(view, { $ });
         }
         return this.onlyDefined(view);

package/dist/cores/transformer.js.map

@@ -1 +1 @@
-{"version":3,"file":"transformer.js","sourceRoot":"","sources":["../../src/cores/transformer.ts"],"names":[],"mappings":";;;AA0HA;;;GAGG;AACH,MAAsB,mBAAmB;IAAzC;QAGI;;;;;WAKG;QACI,WAAM,GAAG,CAAC,GAAW,EAAE,KAAK,GAAG,MAAM,EAAE,EAAE;YAC5C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAC;YAC/C,MAAM,EAAE,GAAG,mDAAmD,CAAC;YAC/D,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,GAAG,gCAAgC,CAAC,CAAC;YACrF,OAAO,GAAG,CAAC;QACf,CAAC,CAAC;QAEF;;;WAGG;QACI,gBAAW,GAAG,CAAmB,CAAY,EAAY,EAAE,CAC9D,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;YACzB,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAC5B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;oBACtC,IAAI,CAAC,KAAK,SAAS;wBAAE,CAAC,CAAC,CAAY,CAAC,GAAG,CAAC,CAAC;oBACzC,OAAO,CAAC,CAAC;gBACb,CAAC,EAAE,EAAO,CAAC;gBACb,CAAC,CAAC,IAAI,CAAC;IAwCnB,CAAC;IAtCG;;;;OAIG;IACI,WAAW,CAAC,KAAsB,EAAE,QAAkB;QACzD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACrD,MAAM,IAAI,GAAS;YACf,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;SAC7B,CAAC;QACF,IAAI,KAAK,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1C,IAAI,QAAQ,EAAE;YACV,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAQ;gBAC9B,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,GAAG,EAAE,KAAK,CAAC,GAAG;aACjB,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;SAC9B;QACD,OAAO,IAAI,CAAC,WAAW,CAAS,IAAc,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,IAAkB,EAAE,QAAkB;;QACrD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACnD,MAAM,KAAK,GAAG,EAAa,CAAC;QAE5B,IAAI,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,EAAE,MAAK,SAAS;YAAE,KAAK,CAAC,EAAE,GAAG,GAAG,MAAA,IAAI,CAAC,EAAE,mCAAI,EAAE,EAAE,CAAC;QAE1D,OAAO,KAAgB,CAAC;IAC5B,CAAC;CACJ;AApED,kDAoEC"}
+{"version":3,"file":"transformer.js","sourceRoot":"","sources":["../../src/cores/transformer.ts"],"names":[],"mappings":";;;AA4HA;;;GAGG;AACH,MAAsB,mBAAmB;IAAzC;QAGI;;;;;WAKG;QACI,WAAM,GAAG,CAAC,GAAW,EAAE,KAAK,GAAG,MAAM,EAAE,EAAE;YAC5C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAC;YAC/C,MAAM,EAAE,GAAG,mDAAmD,CAAC;YAC/D,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,GAAG,gCAAgC,CAAC,CAAC;YACrF,OAAO,GAAG,CAAC;QACf,CAAC,CAAC;QAEF;;;WAGG;QACI,gBAAW,GAAG,CAAmB,CAAY,EAAY,EAAE,CAC9D,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;YACzB,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAC5B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;oBACtC,IAAI,CAAC,KAAK,SAAS;wBAAE,CAAC,CAAC,CAAY,CAAC,GAAG,CAAC,CAAC;oBACzC,OAAO,CAAC,CAAC;gBACb,CAAC,EAAE,EAAO,CAAC;gBACb,CAAC,CAAC,IAAI,CAAC;IAmDnB,CAAC;IAjDG;;;;OAIG;IACI,MAAM,CAAkB,KAAgB;QAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACrD,MAAM,GAAG,GAAG,EAAO,CAAC;QACpB,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzD,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzD,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,WAAW,CAAI,GAAG,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,KAAsB,EAAE,QAAkB;;QACzD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAO;YAChC,CAAC,EAAE,MAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,CAAC,mCAAI,SAAS;YACxB,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;SAC7B,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1C,IAAI,QAAQ,EAAE;YACV,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAQ,KAAK,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;SAC9B;QACD,OAAO,IAAI,CAAC,WAAW,CAAS,IAAc,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,IAAkB,EAAE,QAAkB;;QACrD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACnD,MAAM,KAAK,GAAG,EAAa,CAAC;QAE5B,IAAI,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,EAAE,MAAK,SAAS;YAAE,KAAK,CAAC,EAAE,GAAG,GAAG,MAAA,IAAI,CAAC,EAAE,mCAAI,EAAE,EAAE,CAAC;QAE1D,OAAO,KAAgB,CAAC;IAC5B,CAAC;CACJ;AA/ED,kDA+EC"}

package/dist/genai/dump-test.d.ts

@@ -0,0 +1,82 @@
+/**
+ * `genai/dump-test.ts`
+ * - Browser-facing diagnostic loop for WebSocket transport generate dumps.
+ * - upstream exposed this as `BrowserWebSocketNetwork.dumpTest()`; here the bridge lives in the
+ *   shared socket core, so use the standalone `browserWebSocketDumpTest()` instead.
+ *
+ * @origin eureka-agents-api / src/lib/proxy/dump-test.ts
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+import { WebSocketCompatible } from '../socket/websocket';
+/** single structured log entry emitted by browser dump tests */
+export interface BrowserWebSocketDumpTestLogEntry {
+    time: string;
+    level: 'info' | 'error';
+    event: string;
+    data?: Record<string, unknown>;
+}
+/** options for `browserWebSocketDumpTest()` */
+export interface BrowserWebSocketDumpTestOptions {
+    /** externally owned WebSocket-compatible object */
+    ws?: WebSocketCompatible;
+    /** URL used when `ws` is not supplied */
+    wsUrl?: string;
+    /** `/agents/!/generate` compatible endpoint */
+    endpoint?: string;
+    /** fetch override for tests or sandboxed browser runtimes */
+    fetch?: typeof fetch;
+    /** extra HTTP headers for the generate trigger request */
+    headers?: Record<string, string>;
+    /** connection-id handshake message */
+    connectMessage?: string;
+    /** shared timeout for WebSocket and transport waits */
+    timeoutMs?: number;
+    /** image-capable model used for the dump request */
+    model?: string;
+    /** prompt text paired with the inline image */
+    prompt?: string;
+    /** inline image base64 used by the dump test */
+    imageBase64?: string;
+    /** inline image MIME type */
+    imageMimeType?: string;
+    /** close the WebSocket after the test; defaults to true only for internally created sockets */
+    close?: boolean;
+    /** callback for UI-visible progress logs */
+    log?: (entry: BrowserWebSocketDumpTestLogEntry) => void;
+}
+/** result returned by `browserWebSocketDumpTest()` for UI diagnostics */
+export interface BrowserWebSocketDumpTestResult {
+    ok: boolean;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    endpoint: string;
+    transportId: string;
+    request: {
+        url: string;
+        body: Record<string, unknown>;
+    };
+    ack?: unknown;
+    response?: object;
+    dumped?: any;
+    checks: {
+        ackTransport: boolean;
+        hasOutputText: boolean;
+        dumpParsed: boolean;
+        modelMatches: boolean;
+        inlineMimeTypeMatches: boolean;
+        inlineDataTruncated: boolean;
+        promptTextMatches: boolean;
+        imageRequestMarked: boolean;
+        responseModalitiesKept: boolean;
+    };
+    logs: BrowserWebSocketDumpTestLogEntry[];
+}
+/**
+ * End-to-end browser diagnostic for generate transport.
+ *
+ * It discovers the WebSocket connection id, sends an inline-image `/dump`
+ * request, waits for the JSONTransport response, and returns checks that a UI
+ * can display directly.
+ */
+export declare const browserWebSocketDumpTest: (options?: BrowserWebSocketDumpTestOptions) => Promise<BrowserWebSocketDumpTestResult>;

package/dist/genai/dump-test.js

@@ -0,0 +1,200 @@
+"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.browserWebSocketDumpTest = void 0;
+/**
+ * `genai/dump-test.ts`
+ * - Browser-facing diagnostic loop for WebSocket transport generate dumps.
+ * - upstream exposed this as `BrowserWebSocketNetwork.dumpTest()`; here the bridge lives in the
+ *   shared socket core, so use the standalone `browserWebSocketDumpTest()` instead.
+ *
+ * @origin eureka-agents-api / src/lib/proxy/dump-test.ts
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+const websocket_1 = require("../socket/websocket");
+const transport_1 = require("./transport");
+/**
+ * End-to-end browser diagnostic for generate transport.
+ *
+ * It discovers the WebSocket connection id, sends an inline-image `/dump`
+ * request, waits for the JSONTransport response, and returns checks that a UI
+ * can display directly.
+ */
+const browserWebSocketDumpTest = (options = {}) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
+    const started = Date.now();
+    const startedAt = new Date(started).toISOString();
+    const logs = [];
+    const log = (level, event, data) => {
+        var _a;
+        const entry = {
+            time: new Date().toISOString(),
+            level,
+            event,
+            data,
+        };
+        logs.push(entry);
+        (_a = options.log) === null || _a === void 0 ? void 0 : _a.call(options, entry);
+    };
+    const endpoint = (_a = options.endpoint) !== null && _a !== void 0 ? _a : 'http://localhost:8830/agents/!/generate';
+    const timeoutMs = (_b = options.timeoutMs) !== null && _b !== void 0 ? _b : 30000;
+    const model = (_c = options.model) !== null && _c !== void 0 ? _c : 'gemini-3.1-flash-image-preview';
+    const prompt = (_d = options.prompt) !== null && _d !== void 0 ? _d : 'make a banner from this inline image';
+    const imageBase64 = (_e = options.imageBase64) !== null && _e !== void 0 ? _e : 'abcdefghijklmnopqrstuvwxyz0123456789-browser-websocket-dump-test';
+    const imageMimeType = (_f = options.imageMimeType) !== null && _f !== void 0 ? _f : 'image/jpeg';
+    const ws = (_g = options.ws) !== null && _g !== void 0 ? _g : createDefaultWebSocket((_h = options.wsUrl) !== null && _h !== void 0 ? _h : 'wss://wss.eureka.codes/cht-d1?v2');
+    const shouldClose = (_j = options.close) !== null && _j !== void 0 ? _j : !options.ws;
+    let network;
+    let receiver;
+    try {
+        log('info', 'dumpTest.connectionId.start', { endpoint });
+        const transportId = yield (0, websocket_1.waitWebSocketConnectionId)(ws, {
+            connectMessage: (_k = options.connectMessage) !== null && _k !== void 0 ? _k : 'device.save',
+            timeoutMs,
+        });
+        log('info', 'dumpTest.connectionId.ready', { transportId });
+        network = new websocket_1.BrowserWebSocketNetwork(ws);
+        yield network.ready();
+        receiver = (0, transport_1.createProxyTransportReceiver)(network, { timeoutMs });
+        const url = withQuery(endpoint, { transportId });
+        const body = {
+            model,
+            prompt: {
+                type: 'user',
+                content: {
+                    parts: [
+                        {
+                            inlineData: {
+                                data: imageBase64,
+                                mimeType: imageMimeType,
+                            },
+                        },
+                        {
+                            text: prompt,
+                        },
+                    ],
+                },
+            },
+            system: '/dump',
+            image: true,
+            config: {
+                responseModalities: ['IMAGE', 'TEXT'],
+            },
+        };
+        let ack;
+        log('info', 'dumpTest.fetch.start', { url, model, imageMimeType, imageBase64Length: imageBase64.length });
+        const response = yield receiver.wait(transportId, () => __awaiter(void 0, void 0, void 0, function* () {
+            var _0, _1, _2;
+            const fetcher = (_0 = options.fetch) !== null && _0 !== void 0 ? _0 : globalThis.fetch;
+            const http = yield callFetch(fetcher, url, {
+                method: 'POST',
+                headers: Object.assign({ 'content-type': 'application/json' }, ((_1 = options.headers) !== null && _1 !== void 0 ? _1 : {})),
+                body: JSON.stringify(body),
+            });
+            const text = yield http.text();
+            ack = (_2 = tryParseJSON(text)) !== null && _2 !== void 0 ? _2 : text;
+            if (!http.ok)
+                throw new Error(`HTTP ${http.status} ${http.statusText}`.trim() + (text ? ` - ${text}` : ''));
+            log('info', 'dumpTest.fetch.ack', {
+                status: http.status,
+                transport: !!(ack === null || ack === void 0 ? void 0 : ack.transport),
+                transportId: ack === null || ack === void 0 ? void 0 : ack.transportId,
+            });
+            return ack;
+        }));
+        const outputText = asGenAIOutputText(response);
+        const dumped = outputText ? tryParseJSON(outputText) : undefined;
+        const checks = {
+            ackTransport: !!(ack === null || ack === void 0 ? void 0 : ack.transport),
+            hasOutputText: typeof outputText === 'string' && outputText.length > 0,
+            dumpParsed: !!dumped,
+            modelMatches: (dumped === null || dumped === void 0 ? void 0 : dumped.model) === model,
+            inlineMimeTypeMatches: ((_p = (_o = (_m = (_l = dumped === null || dumped === void 0 ? void 0 : dumped.contents) === null || _l === void 0 ? void 0 : _l.parts) === null || _m === void 0 ? void 0 : _m[0]) === null || _o === void 0 ? void 0 : _o.inlineData) === null || _p === void 0 ? void 0 : _p.mimeType) === imageMimeType,
+            inlineDataTruncated: ((_t = (_s = (_r = (_q = dumped === null || dumped === void 0 ? void 0 : dumped.contents) === null || _q === void 0 ? void 0 : _q.parts) === null || _r === void 0 ? void 0 : _r[0]) === null || _s === void 0 ? void 0 : _s.inlineData) === null || _t === void 0 ? void 0 : _t.data) === imageBase64.substring(0, 36),
+            promptTextMatches: ((_w = (_v = (_u = dumped === null || dumped === void 0 ? void 0 : dumped.contents) === null || _u === void 0 ? void 0 : _u.parts) === null || _v === void 0 ? void 0 : _v[1]) === null || _w === void 0 ? void 0 : _w.text) === prompt,
+            imageRequestMarked: ((_x = dumped === null || dumped === void 0 ? void 0 : dumped.$param) === null || _x === void 0 ? void 0 : _x.isImage) === true,
+            responseModalitiesKept: JSON.stringify((_z = (_y = dumped === null || dumped === void 0 ? void 0 : dumped.$param) === null || _y === void 0 ? void 0 : _y.config) === null || _z === void 0 ? void 0 : _z.responseModalities) === JSON.stringify(['IMAGE', 'TEXT']),
+        };
+        const ok = Object.values(checks).every(Boolean);
+        const finished = Date.now();
+        const result = {
+            ok,
+            startedAt,
+            finishedAt: new Date(finished).toISOString(),
+            durationMs: finished - started,
+            endpoint,
+            transportId,
+            request: { url, body },
+            ack,
+            response,
+            dumped,
+            checks,
+            logs,
+        };
+        log(ok ? 'info' : 'error', 'dumpTest.done', { ok, checks });
+        return result;
+    }
+    catch (error) {
+        log('error', 'dumpTest.failed', { error: normalizeError(error) });
+        throw error;
+    }
+    finally {
+        receiver === null || receiver === void 0 ? void 0 : receiver.detach();
+        network === null || network === void 0 ? void 0 : network.detach();
+        if (shouldClose && typeof ws.close === 'function')
+            ws.close();
+    }
+});
+exports.browserWebSocketDumpTest = browserWebSocketDumpTest;
+const createDefaultWebSocket = (url) => {
+    const WebSocketCtor = globalThis.WebSocket;
+    if (!WebSocketCtor)
+        throw new Error(`global WebSocket is not available - browserWebSocketDumpTest`);
+    return new WebSocketCtor(url);
+};
+const withQuery = (endpoint, params) => {
+    const url = new URL(endpoint, 'http://localhost');
+    for (const [key, value] of Object.entries(params))
+        url.searchParams.set(key, value);
+    if (/^https?:\/\//.test(endpoint))
+        return url.toString();
+    return `${url.pathname}${url.search}${url.hash}`;
+};
+const callFetch = (fetcher, input, init) => fetcher.call(globalThis, input, init);
+const asGenAIOutputText = (response) => {
+    var _a;
+    const content = (_a = response === null || response === void 0 ? void 0 : response.output) === null || _a === void 0 ? void 0 : _a.content;
+    if (typeof content === 'string')
+        return content;
+    const data = content && typeof content === 'object' ? content.data : undefined;
+    return typeof data === 'string' ? data : undefined;
+};
+const tryParseJSON = (text) => {
+    try {
+        return JSON.parse(text);
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
+const normalizeError = (error) => {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === 'string')
+        return error;
+    try {
+        return JSON.stringify(error);
+    }
+    catch (_a) {
+        return String(error);
+    }
+};
+//# sourceMappingURL=dump-test.js.map

package/dist/genai/dump-test.js.map

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

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/dist/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,0EAA0E;AAC1E,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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"}