lemon-model 1.2.0 → 1.2.2

package/dist/buffer/testing.js

@@ -0,0 +1,92 @@
+"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.runGenAIStreamNetworkLoop = void 0;
+/**
+ * `buffer/testing.ts`
+ * - isolated entry for GenAI stream buffer diagnostic helpers.
+ * - kept OUT of the package root barrel so production bundles do not include the in-memory socket simulator.
+ *
+ * Usage (tests / dev only):
+ *   import { runGenAIStreamNetworkLoop } from 'lemon-model/buffer/testing';
+ *
+ * @origin eureka-agents-api / src/lib/buffer/network.ts
+ * @copyright (C) 2026 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+const socket_1 = require("../socket/socket");
+const stream_1 = require("./stream");
+const network_1 = require("./network");
+/**
+ * Run an end-to-end diagnostic loop:
+ * tokens -> GenAIStreamBuffer -> JSONTransport -> NetworkSupportable ->
+ * JSONTransport -> GenAIStreamConsumer.
+ *
+ * This helper is intended for tests, smoke checks, and lightweight performance
+ * probes in environments that can provide a NetworkSupportable.
+ */
+const runGenAIStreamNetworkLoop = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const startedAt = Date.now();
+    const network = (_a = options.network) !== null && _a !== void 0 ? _a : (0, socket_1.createNetwork)(Object.assign({ id: (_c = (_b = options.networkOptions) === null || _b === void 0 ? void 0 : _b.id) !== null && _c !== void 0 ? _c : options.id }, options.networkOptions));
+    const streamNetwork = Object.assign(Object.assign({}, ((_d = options.streamNetwork) !== null && _d !== void 0 ? _d : {})), { maxPacketBytes: (_f = (_e = options.streamNetwork) === null || _e === void 0 ? void 0 : _e.maxPacketBytes) !== null && _f !== void 0 ? _f : (_g = options.networkOptions) === null || _g === void 0 ? void 0 : _g.maxPacketBytes });
+    const events = [];
+    const rawPackets = [];
+    const unsubscribeRaw = network.onMessage(packet => rawPackets.push(packet));
+    const receiver = (0, network_1.createGenAIStreamNetworkReceiver)(network, event => {
+        events.push(event);
+    }, streamNetwork);
+    const sender = (0, network_1.createGenAIStreamNetworkConsumer)(network, streamNetwork);
+    const buffer = new stream_1.GenAIStreamBuffer(sender.consumer, options.bufferOptions);
+    try {
+        yield buffer.start();
+        for (const token of options.tokens)
+            yield buffer.write(token);
+        yield buffer.close();
+        yield new Promise(resolve => { var _a; return setTimeout(resolve, (_a = options.settleMs) !== null && _a !== void 0 ? _a : 50); });
+        const snapshot = buffer.snapshot();
+        const packetBytes = rawPackets.reduce((sum, packet) => sum + byteLength(packet), 0);
+        const maxPacketBytes = rawPackets.reduce((max, packet) => Math.max(max, byteLength(packet)), 0);
+        const chunkPackets = rawPackets.filter(packet => {
+            var _a;
+            try {
+                return ((_a = JSON.parse(packet)) === null || _a === void 0 ? void 0 : _a.type) === 'json:chunk';
+            }
+            catch (_b) {
+                return false;
+            }
+        }).length;
+        return {
+            events,
+            rawPackets,
+            snapshot,
+            network,
+            metrics: {
+                elapsedMs: Date.now() - startedAt,
+                packets: rawPackets.length,
+                packetBytes,
+                maxPacketBytes,
+                chunkPackets,
+                events: events.length,
+            },
+        };
+    }
+    finally {
+        unsubscribeRaw();
+        sender.detach();
+        receiver.detach();
+        if (!options.network)
+            network.close();
+    }
+});
+exports.runGenAIStreamNetworkLoop = runGenAIStreamNetworkLoop;
+const textEncoder = new TextEncoder();
+const byteLength = (value) => textEncoder.encode(value).length;
+//# sourceMappingURL=testing.js.map

package/dist/buffer/testing.js.map

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

package/dist/buffer/token.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `buffer/token.ts`
+ * - Legacy token-string buffering helper.
+ *
+ * @origin eureka-agents-api / src/lib/buffer/token.ts
+ *
+ * type: `TokenBufferOptions`
+ */
+export interface TokenBufferOptions {
+    /** buffer flush strategy */
+    flushStrategy?: 'time' | 'size';
+    /** time-based flush interval in ms */
+    bufferMs?: number;
+    /** max tokens before force flush in time strategy */
+    maxTokensForTime?: number;
+    /** size-based flush when token count reaches this */
+    bufferSize?: number;
+    /** max wait time in ms for size strategy */
+    maxWaitMs?: number;
+    /** enable buffer (default: true) */
+    useBuffer?: boolean;
+}
+/**
+ * class: `TokenBuffer`
+ * - manages token buffering with configurable flush strategies
+ */
+export declare class TokenBuffer {
+    private flushCallback;
+    private tokens;
+    private timer?;
+    private isProcessing;
+    private readonly options;
+    constructor(flushCallback: (content: string) => Promise<void>, options?: TokenBufferOptions);
+    /**
+     * add token to buffer
+     */
+    add(token: string): Promise<void>;
+    /**
+     * flush all buffered tokens
+     */
+    flush(): Promise<void>;
+    /**
+     * close buffer and flush remaining tokens
+     */
+    close(): Promise<void>;
+    private scheduleTimeFlush;
+    private scheduleMaxWaitFlush;
+    private clearTimer;
+}

package/dist/buffer/token.js

@@ -0,0 +1,112 @@
+"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.TokenBuffer = void 0;
+/**
+ * class: `TokenBuffer`
+ * - manages token buffering with configurable flush strategies
+ */
+class TokenBuffer {
+    constructor(flushCallback, options) {
+        var _a, _b, _c, _d, _e, _f;
+        this.flushCallback = flushCallback;
+        this.tokens = [];
+        this.isProcessing = false;
+        this.options = {
+            flushStrategy: (_a = options === null || options === void 0 ? void 0 : options.flushStrategy) !== null && _a !== void 0 ? _a : 'size',
+            bufferMs: (_b = options === null || options === void 0 ? void 0 : options.bufferMs) !== null && _b !== void 0 ? _b : 300,
+            maxTokensForTime: (_c = options === null || options === void 0 ? void 0 : options.maxTokensForTime) !== null && _c !== void 0 ? _c : 30,
+            bufferSize: (_d = options === null || options === void 0 ? void 0 : options.bufferSize) !== null && _d !== void 0 ? _d : 10,
+            maxWaitMs: (_e = options === null || options === void 0 ? void 0 : options.maxWaitMs) !== null && _e !== void 0 ? _e : 300,
+            useBuffer: (_f = options === null || options === void 0 ? void 0 : options.useBuffer) !== null && _f !== void 0 ? _f : true,
+        };
+    }
+    /**
+     * add token to buffer
+     */
+    add(token) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.options.useBuffer) {
+                yield this.flushCallback(token);
+                return;
+            }
+            this.tokens.push(token);
+            if (this.options.flushStrategy === 'size') {
+                // size 전략: 개수 도달하면 flush, 아니면 최대 대기시간 타이머
+                if (this.tokens.length >= this.options.bufferSize) {
+                    yield this.flush();
+                }
+                else {
+                    this.scheduleMaxWaitFlush();
+                }
+            }
+            else {
+                // time 전략: 일정 개수 되면 강제 flush, 아니면 시간 타이머
+                if (this.tokens.length >= this.options.maxTokensForTime) {
+                    yield this.flush();
+                }
+                else {
+                    this.scheduleTimeFlush();
+                }
+            }
+        });
+    }
+    /**
+     * flush all buffered tokens
+     */
+    flush() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.isProcessing || this.tokens.length === 0)
+                return;
+            this.isProcessing = true;
+            this.clearTimer();
+            const content = this.tokens.join('');
+            this.tokens = [];
+            try {
+                yield this.flushCallback(content);
+            }
+            finally {
+                this.isProcessing = false;
+            }
+        });
+    }
+    /**
+     * close buffer and flush remaining tokens
+     */
+    close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.flush();
+            this.clearTimer();
+        });
+    }
+    scheduleTimeFlush() {
+        if (this.timer)
+            return;
+        this.timer = setTimeout(() => __awaiter(this, void 0, void 0, function* () {
+            yield this.flush();
+        }), this.options.bufferMs);
+    }
+    scheduleMaxWaitFlush() {
+        if (this.timer)
+            return;
+        this.timer = setTimeout(() => __awaiter(this, void 0, void 0, function* () {
+            yield this.flush();
+        }), this.options.maxWaitMs);
+    }
+    clearTimer() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+    }
+}
+exports.TokenBuffer = TokenBuffer;
+//# sourceMappingURL=token.js.map

package/dist/buffer/token.js.map

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

package/dist/esm/buffer/index.js

@@ -0,0 +1,10 @@
+/**
+ * `buffer/index.ts`
+ * - Public exports for token, stream, and network buffering utilities.
+ *
+ * @origin eureka-agents-api / src/lib/buffer/index.ts
+ */
+export * from './token.js';
+export * from './stream.js';
+export * from './network.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/buffer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/buffer/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}

package/dist/esm/buffer/network.js

@@ -0,0 +1,163 @@
+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;
+};
+/**
+ * `buffer/network.ts`
+ * - Network transport adapters and diagnostics for GenAI stream events.
+ *
+ * @origin eureka-agents-api / src/lib/buffer/network.ts
+ *
+ * GenAIStreamConsumer emits typed events, while NetworkSupportable only accepts
+ * raw strings and may enforce a packet-size limit. This adapter keeps those
+ * concerns separate by sending stream events through JSONTransport.
+ */
+import { calculateJSONTransportChunkBytes, createJSONTransport, } from '../socket/transport.js';
+// eslint-disable-next-line prettier/prettier
+const STREAM_EVENT_SPLIT_PATHS = ['/event/data', '/event/chunks/*/data', '/event/error/message', '/event/error/stack'];
+export const asGenAIStreamNetworkTransportOptions = (options) => {
+    var _a, _b, _c;
+    const jsonTransport = (_a = options === null || options === void 0 ? void 0 : options.jsonTransport) !== null && _a !== void 0 ? _a : {};
+    const chunkBytes = (_b = jsonTransport.chunkBytes) !== null && _b !== void 0 ? _b : ((options === null || options === void 0 ? void 0 : options.maxPacketBytes)
+        ? calculateJSONTransportChunkBytes(options.maxPacketBytes, jsonTransport.envelopeReserveBytes)
+        : undefined);
+    return Object.assign(Object.assign({}, jsonTransport), { chunkBytes, 
+        // eslint-disable-next-line prettier/prettier
+        preferredSplitPaths: [...STREAM_EVENT_SPLIT_PATHS, ...((_c = jsonTransport.preferredSplitPaths) !== null && _c !== void 0 ? _c : [])] });
+};
+/**
+ * Create a GenAIStreamConsumer that serializes stream events and sends them over
+ * NetworkSupportable via JSONTransport.
+ *
+ * The returned consumer preserves the normal GenAIStreamConsumer contract. The
+ * only network-specific behavior is packet wrapping, optional flush compaction,
+ * and JSONTransport splitting for large string payloads.
+ */
+export const createGenAIStreamNetworkConsumer = (network, options) => {
+    var _a;
+    const transport = createJSONTransport(network, asGenAIStreamNetworkTransportOptions(options));
+    const waitReady = (_a = options === null || options === void 0 ? void 0 : options.waitReady) !== null && _a !== void 0 ? _a : true;
+    let seq = 0;
+    const consumer = (event) => __awaiter(void 0, void 0, void 0, function* () {
+        if (waitReady && network.ready)
+            yield network.ready();
+        const compacted = (options === null || options === void 0 ? void 0 : options.compactFlush) ? compactStreamEvent(event) : { event };
+        transport.send(Object.assign({ type: 'genai:stream', sid: options === null || options === void 0 ? void 0 : options.streamId, seq: seq++, sentAt: Date.now() }, compacted));
+    });
+    return {
+        consumer,
+        transport,
+        detach: () => transport.detach(),
+    };
+};
+/**
+ * Receive GenAI stream event packets from a NetworkSupportable and forward the
+ * rebuilt events to a GenAIStreamConsumer.
+ *
+ * When reorder is enabled, packets are held until their seq number can be
+ * delivered contiguously. This is intentionally stream-local; callers should set
+ * streamId when multiplexing multiple streams over one network. On the wire,
+ * that stream id is carried as the compact `sid` field.
+ */
+export const createGenAIStreamNetworkReceiver = (network, consumer, options) => {
+    const transport = createJSONTransport(network, asGenAIStreamNetworkTransportOptions(options));
+    // Reordering is deliberately simple: it waits for contiguous seq numbers
+    // from zero. A higher-level timeout policy should own missing packets.
+    let nextSeq = 0;
+    const pending = new Map();
+    const deliver = (packet) => {
+        const event = restoreStreamEvent(packet);
+        void Promise.resolve(consumer(event)).catch(error => {
+            var _a;
+            (_a = options === null || options === void 0 ? void 0 : options.onConsumerError) === null || _a === void 0 ? void 0 : _a.call(options, error, { scope: 'genai.stream.consumer', network });
+        });
+    };
+    const accept = (packet) => {
+        var _a;
+        (_a = options === null || options === void 0 ? void 0 : options.onPacket) === null || _a === void 0 ? void 0 : _a.call(options, packet);
+        if (!(options === null || options === void 0 ? void 0 : options.reorder)) {
+            deliver(packet);
+            return;
+        }
+        pending.set(packet.seq, packet);
+        while (pending.has(nextSeq)) {
+            const ordered = pending.get(nextSeq);
+            pending.delete(nextSeq++);
+            deliver(ordered);
+        }
+    };
+    transport.onMessage(packet => {
+        if ((packet === null || packet === void 0 ? void 0 : packet.type) !== 'genai:stream')
+            return;
+        if ((options === null || options === void 0 ? void 0 : options.streamId) && packet.sid !== options.streamId)
+            return;
+        accept(packet);
+    });
+    return {
+        transport,
+        detach: () => transport.detach(),
+    };
+};
+/** subscribe to JSONTransport/network errors from a stream network handle */
+export const onGenAIStreamNetworkError = (handle, handler) => handle.transport.onError(handler);
+export const compactStreamEvent = (event) => {
+    if (event.type !== 'flush' || !canCompactFlushEvent(event))
+        return { event };
+    return {
+        event: Object.assign(Object.assign({}, event), { chunks: event.chunks.map(chunk => {
+                const { data: _data } = chunk, rest = __rest(chunk, ["data"]);
+                return rest;
+            }) }),
+        compact: { flushChunksData: 'fromFlushData' },
+    };
+};
+/**
+ * Restore a network packet into the public GenAIStreamEvent shape expected by
+ * downstream consumers.
+ */
+export const restoreStreamEvent = (packet) => {
+    var _a;
+    const event = packet.event;
+    if (event.type !== 'flush' || ((_a = packet.compact) === null || _a === void 0 ? void 0 : _a.flushChunksData) !== 'fromFlushData')
+        return event;
+    let offset = 0;
+    return Object.assign(Object.assign({}, event), { chunks: event.chunks.map(chunk => {
+            var _a;
+            const chars = (_a = chunk.chars) !== null && _a !== void 0 ? _a : 0;
+            const data = event.data.substring(offset, offset + chars);
+            offset += chars;
+            return Object.assign(Object.assign({}, chunk), { data });
+        }) });
+};
+/**
+ * Flush events normally carry both joined data and per-chunk data. Compacting is
+ * safe only when chunk data is exactly contiguous within flush.data.
+ */
+const canCompactFlushEvent = (event) => {
+    var _a;
+    let offset = 0;
+    for (const chunk of event.chunks) {
+        const chars = (_a = chunk.chars) !== null && _a !== void 0 ? _a : chunk.data.length;
+        if (event.data.substring(offset, offset + chars) !== chunk.data)
+            return false;
+        offset += chars;
+    }
+    return offset === event.data.length;
+};
+//# sourceMappingURL=network.js.map

package/dist/esm/buffer/network.js.map

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