@realtimex/node-llama-cpp 0.1.0

package/dist/utils/safeEventCallback.js

@@ -0,0 +1,29 @@
+const safeCallbackSymbol = Symbol("safeCallback");
+export function safeEventCallback(callback, message) {
+    if (callback == null)
+        return undefined;
+    // do not wrap the callback if it's already wrapped
+    if (callback?.[safeCallbackSymbol] === true)
+        return callback;
+    const res = (...args) => {
+        try {
+            const res = callback(...args);
+            if (res instanceof Promise)
+                res.catch((error) => {
+                    if (message != null)
+                        console.error(message, error);
+                    else
+                        console.error(error);
+                });
+        }
+        catch (error) {
+            if (message != null)
+                console.error(message, error);
+            else
+                console.error(error);
+        }
+    };
+    res[safeCallbackSymbol] = true;
+    return res;
+}
+//# sourceMappingURL=safeEventCallback.js.map

package/dist/utils/safeEventCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeEventCallback.js","sourceRoot":"","sources":["../../src/utils/safeEventCallback.ts"],"names":[],"mappings":"AAAA,MAAM,kBAAkB,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AAelD,MAAM,UAAU,iBAAiB,CAC7B,QAC+C,EAC/C,OAAgB;IAEhB,IAAI,QAAQ,IAAI,IAAI;QAChB,OAAO,SAAS,CAAC;IAErB,mDAAmD;IACnD,IAAK,QAAgB,EAAE,CAAC,kBAAkB,CAAC,KAAK,IAAI;QAChD,OAAO,QAAQ,CAAC;IAEpB,MAAM,GAAG,GAAG,CAAC,GAAG,IAAY,EAAE,EAAE;QAC5B,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;YAE9B,IAAI,GAAG,YAAY,OAAO;gBACtB,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;oBAChB,IAAI,OAAO,IAAI,IAAI;wBACf,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;;wBAE9B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC7B,CAAC,CAAC,CAAC;QACX,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,OAAO,IAAI,IAAI;gBACf,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;;gBAE9B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACL,CAAC,CAAC;IACF,GAAG,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;IAE/B,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/utils/signalSleep.d.ts

@@ -0,0 +1 @@
+export declare function signalSleep(delay: number, abortSignal?: AbortSignal): Promise<void>;

package/dist/utils/signalSleep.js

@@ -0,0 +1,20 @@
+export function signalSleep(delay, abortSignal) {
+    return new Promise((accept, reject) => {
+        if (abortSignal?.aborted)
+            return void reject(abortSignal.reason);
+        let timeout = undefined;
+        function onAbort() {
+            reject(abortSignal?.reason);
+            clearTimeout(timeout);
+            abortSignal?.removeEventListener("abort", onAbort);
+        }
+        function onTimeout() {
+            accept();
+            timeout = undefined;
+            abortSignal?.removeEventListener("abort", onAbort);
+        }
+        abortSignal?.addEventListener("abort", onAbort);
+        timeout = setTimeout(onTimeout, delay);
+    });
+}
+//# sourceMappingURL=signalSleep.js.map

package/dist/utils/signalSleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalSleep.js","sourceRoot":"","sources":["../../src/utils/signalSleep.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,WAAyB;IAChE,OAAO,IAAI,OAAO,CAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QACxC,IAAI,WAAW,EAAE,OAAO;YACpB,OAAO,KAAK,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAE3C,IAAI,OAAO,GAA8C,SAAS,CAAC;QACnE,SAAS,OAAO;YACZ,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAC5B,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,WAAW,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACvD,CAAC;QAED,SAAS,SAAS;YACd,MAAM,EAAE,CAAC;YACT,OAAO,GAAG,SAAS,CAAC;YACpB,WAAW,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACvD,CAAC;QAED,WAAW,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,GAAG,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/utils/spawnCommand.d.ts

@@ -0,0 +1,11 @@
+export declare function spawnCommand(command: string, args: string[], cwd: string, env?: NodeJS.ProcessEnv, progressLogs?: boolean): Promise<{
+    stdout: string;
+    stderr: string;
+    combinedStd: string;
+}>;
+export declare class SpawnError extends Error {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly combinedStd: string;
+    constructor(message: string, stdout: string, stderr: string, combinedStd: string);
+}

package/dist/utils/spawnCommand.js

@@ -0,0 +1,89 @@
+import spawn from "cross-spawn";
+export function spawnCommand(command, args, cwd, env = process.env, progressLogs = true) {
+    function getCommandString() {
+        let res = command;
+        for (const arg of args) {
+            if (arg.includes(" ")) {
+                res += ` "${arg.split('"').join('\\"')}"`;
+            }
+            else {
+                res += ` ${arg}`;
+            }
+        }
+        return res;
+    }
+    return new Promise((resolve, reject) => {
+        const stdout = [];
+        const stderr = [];
+        const combinedStd = [];
+        function createResult() {
+            const finalStdout = stdout.join("");
+            stdout.length = 0;
+            const finalStderr = stderr.join("");
+            stderr.length = 0;
+            const finalCombinedStd = combinedStd.join("");
+            combinedStd.length = 0;
+            return {
+                stdout: finalStdout,
+                stderr: finalStderr,
+                combinedStd: finalCombinedStd
+            };
+        }
+        function createError(message) {
+            const { stdout: finalStdout, stderr: finalStderr, combinedStd: finalCombinedStd } = createResult();
+            return new SpawnError(message, finalStdout, finalStderr, finalCombinedStd);
+        }
+        const child = spawn(command, args, {
+            stdio: [null, null, null],
+            cwd,
+            env,
+            detached: false,
+            windowsHide: true
+        });
+        child.on("exit", (code) => {
+            if (code == 0)
+                resolve(createResult());
+            else
+                reject(createError(`Command ${getCommandString()} exited with code ${code}`));
+        });
+        child.on("error", reject);
+        child.on("disconnect", () => reject(new Error(`Command ${getCommandString()} disconnected`)));
+        child.on("close", (code) => {
+            if (code == 0)
+                resolve(createResult());
+            else
+                reject(createError(`Command ${getCommandString()} closed with code ${code}`));
+        });
+        if (progressLogs) {
+            child.stdout?.pipe(process.stdout);
+            child.stderr?.pipe(process.stderr);
+            process.stdin.pipe(child.stdin);
+        }
+        else {
+            child.stderr?.pipe(process.stderr);
+        }
+        child.stdout?.on("data", (data) => {
+            stdout.push(data.toString());
+            combinedStd.push(data.toString());
+        });
+        child.stderr?.on("data", (data) => {
+            stderr.push(data.toString());
+            combinedStd.push(data.toString());
+        });
+    });
+}
+export class SpawnError extends Error {
+    stdout;
+    stderr;
+    combinedStd;
+    constructor(message, stdout, stderr, combinedStd) {
+        super(message);
+        Object.defineProperty(this, "stdout", { enumerable: false });
+        Object.defineProperty(this, "stderr", { enumerable: false });
+        Object.defineProperty(this, "combinedStd", { enumerable: false });
+        this.stdout = stdout;
+        this.stderr = stderr;
+        this.combinedStd = combinedStd;
+    }
+}
+//# sourceMappingURL=spawnCommand.js.map

package/dist/utils/spawnCommand.js.map

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

package/dist/utils/tokenizeInput.d.ts

@@ -0,0 +1,3 @@
+import { Token, Tokenizer } from "../types.js";
+import { LlamaText } from "./LlamaText.js";
+export declare function tokenizeInput(input: Token | Token[] | string | LlamaText, tokenizer: Tokenizer, options?: "trimLeadingSpace", clone?: boolean): Token[];

package/dist/utils/tokenizeInput.js

@@ -0,0 +1,14 @@
+import { isLlamaText } from "./LlamaText.js";
+import { isToken } from "./isToken.js";
+export function tokenizeInput(input, tokenizer, options, clone = false) {
+    if (typeof input === "string")
+        return tokenizer(input, false, options);
+    else if (isLlamaText(input))
+        return input.tokenize(tokenizer, options);
+    else if (isToken(input))
+        return [input];
+    if (clone)
+        return input.slice();
+    return input;
+}
+//# sourceMappingURL=tokenizeInput.js.map

package/dist/utils/tokenizeInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizeInput.js","sourceRoot":"","sources":["../../src/utils/tokenizeInput.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAY,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AAErC,MAAM,UAAU,aAAa,CACzB,KAA2C,EAC3C,SAAoB,EACpB,OAA4B,EAC5B,QAAiB,KAAK;IAEtB,IAAI,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;SACvC,IAAI,WAAW,CAAC,KAAK,CAAC;QACvB,OAAO,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;SACzC,IAAI,OAAO,CAAC,KAAK,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,CAAC;IAEnB,IAAI,KAAK;QACL,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC;IAEzB,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/utils/tokenizerUtils.d.ts

@@ -0,0 +1,12 @@
+import { LlamaVocabularyType } from "../bindings/types.js";
+import type { LlamaModelTokens } from "../evaluator/LlamaModel/LlamaModel.js";
+/**
+ * Resolve whether a token has to be prepended at the beginning of the input, and what should it be,
+ * based on the tokenizer implementation in `llama.cpp` under the `llama_tokenize_internal` function in `llama-vocab.cpp`
+ */
+export declare function resolveBeginningTokenToPrepend(vocabularyType: LlamaVocabularyType, tokens: LlamaModelTokens): import("../types.js").Token | null;
+/**
+ * Resolve whether a token has to be appended at the end of the input, and what should it be,
+ * based on the tokenizer implementation in `llama.cpp` under the `llama_tokenize_internal` function in `llama-vocab.cpp`
+ */
+export declare function resolveEndTokenToAppend(vocabularyType: LlamaVocabularyType, tokens: LlamaModelTokens): import("../types.js").Token | null;

package/dist/utils/tokenizerUtils.js

@@ -0,0 +1,32 @@
+import { LlamaVocabularyType } from "../bindings/types.js";
+/**
+ * Resolve whether a token has to be prepended at the beginning of the input, and what should it be,
+ * based on the tokenizer implementation in `llama.cpp` under the `llama_tokenize_internal` function in `llama-vocab.cpp`
+ */
+export function resolveBeginningTokenToPrepend(vocabularyType, tokens) {
+    if (vocabularyType === LlamaVocabularyType.rwkv)
+        return null;
+    if (vocabularyType === LlamaVocabularyType.wpm)
+        return tokens.bos;
+    if (vocabularyType === LlamaVocabularyType.ugm)
+        return null;
+    if (tokens.shouldPrependBosToken)
+        return tokens.bos;
+    return null;
+}
+/**
+ * Resolve whether a token has to be appended at the end of the input, and what should it be,
+ * based on the tokenizer implementation in `llama.cpp` under the `llama_tokenize_internal` function in `llama-vocab.cpp`
+ */
+export function resolveEndTokenToAppend(vocabularyType, tokens) {
+    if (vocabularyType === LlamaVocabularyType.rwkv)
+        return null;
+    if (vocabularyType === LlamaVocabularyType.wpm)
+        return tokens.sep;
+    if (vocabularyType === LlamaVocabularyType.ugm)
+        return tokens.eos;
+    if (tokens.shouldAppendEosToken)
+        return tokens.eos;
+    return null;
+}
+//# sourceMappingURL=tokenizerUtils.js.map

package/dist/utils/tokenizerUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizerUtils.js","sourceRoot":"","sources":["../../src/utils/tokenizerUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAC,MAAM,sBAAsB,CAAC;AAGzD;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,cAAmC,EAAE,MAAwB;IACxG,IAAI,cAAc,KAAK,mBAAmB,CAAC,IAAI;QAC3C,OAAO,IAAI,CAAC;IAEhB,IAAI,cAAc,KAAK,mBAAmB,CAAC,GAAG;QAC1C,OAAO,MAAM,CAAC,GAAG,CAAC;IAGtB,IAAI,cAAc,KAAK,mBAAmB,CAAC,GAAG;QAC1C,OAAO,IAAI,CAAC;IAEhB,IAAI,MAAM,CAAC,qBAAqB;QAC5B,OAAO,MAAM,CAAC,GAAG,CAAC;IAEtB,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,cAAmC,EAAE,MAAwB;IACjG,IAAI,cAAc,KAAK,mBAAmB,CAAC,IAAI;QAC3C,OAAO,IAAI,CAAC;IAEhB,IAAI,cAAc,KAAK,mBAAmB,CAAC,GAAG;QAC1C,OAAO,MAAM,CAAC,GAAG,CAAC;IAEtB,IAAI,cAAc,KAAK,mBAAmB,CAAC,GAAG;QAC1C,OAAO,MAAM,CAAC,GAAG,CAAC;IAEtB,IAAI,MAAM,CAAC,oBAAoB;QAC3B,OAAO,MAAM,CAAC,GAAG,CAAC;IAEtB,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/utils/transformPromisable.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Transform a value that can be a promise or a value.
+ *
+ * This is used as a performance optimization to avoid adding many microtasks to the event loop,
+ * which makes reading from buffers significantly faster.
+ * @param value - The value to transform, can be a promise or a value
+ * @param transformer - The transformer function
+ * @returns The transformed value. If the input value is a promise, the return value will also be a promise.
+ */
+export declare function transformPromisable<T, R>(value: Promisable<T>, transformer: (value: T) => Promisable<R>): Promisable<R>;
+/**
+ * Transform multiple values that can be promises or values.
+ *
+ * This is used as a performance optimization to avoid adding many microtasks to the event loop,
+ * which makes reading from buffers significantly faster.
+ * @param values - The values to transform, can be promises or values
+ * @param transformer - The transformer function
+ */
+export declare function transformPromisables<const Types extends readonly any[], R>(values: {
+    [Index in keyof Types]: Promisable<Types[Index]>;
+}, transformer: (values: {
+    [Index in keyof Types]: Types[Index];
+}) => Promisable<R>): Promisable<R>;
+/**
+ * An implementation of a loop that waits on promises only when the value is a promise, and otherwise continues synchronously.
+ *
+ * This is a performance optimization to avoid adding many microtasks to the event loop,
+ * which makes reading from buffers significantly faster.
+ */
+export declare function promisableLoop<R>({ condition, callback, afterthought, returnValue }: {
+    /** The condition to check before each iteration */
+    condition: () => Promisable<boolean>;
+    /** The callback to run on each iteration */
+    callback: () => Promisable<void>;
+    /** An afterthought to run after each iteration */
+    afterthought?: () => Promisable<void>;
+    /** The value to return when the loop is done */
+    returnValue: () => Promisable<R>;
+}): Promisable<R>;
+/**
+ * Calls the given getters in order, and when a promise is encountered, waits for it to resolve before continuing.
+ * The result is transformed using the transformer function.
+ *
+ * This is used as a performance optimization to avoid adding many microtasks to the event loop,
+ * which makes reading from buffers significantly faster.
+ * @param getters - An array of functions that return values or promises
+ * @param transformer - The transformer function that takes the promisable values and transforms them into the result of this function
+ */
+export declare function transformPromisablesInOrder<const T extends (() => Promisable<any>)[], const R = {
+    readonly [Index in keyof T]: Awaited<ReturnType<T[Index]>>;
+}>(getters: T, transformer?: (values: {
+    readonly [Index in keyof T]: Awaited<ReturnType<T[Index]>>;
+}) => Promisable<R>): Promisable<R>;
+export type Promisable<T> = T | Promise<T>;

package/dist/utils/transformPromisable.js

@@ -0,0 +1,95 @@
+/**
+ * Transform a value that can be a promise or a value.
+ *
+ * This is used as a performance optimization to avoid adding many microtasks to the event loop,
+ * which makes reading from buffers significantly faster.
+ * @param value - The value to transform, can be a promise or a value
+ * @param transformer - The transformer function
+ * @returns The transformed value. If the input value is a promise, the return value will also be a promise.
+ */
+export function transformPromisable(value, transformer) {
+    if (value instanceof Promise)
+        return value.then(transformer);
+    return transformer(value);
+}
+/**
+ * Transform multiple values that can be promises or values.
+ *
+ * This is used as a performance optimization to avoid adding many microtasks to the event loop,
+ * which makes reading from buffers significantly faster.
+ * @param values - The values to transform, can be promises or values
+ * @param transformer - The transformer function
+ */
+export function transformPromisables(values, transformer) {
+    if (values.some((value) => value instanceof Promise))
+        return Promise.all(values).then(transformer);
+    return transformer(values);
+}
+/**
+ * An implementation of a loop that waits on promises only when the value is a promise, and otherwise continues synchronously.
+ *
+ * This is a performance optimization to avoid adding many microtasks to the event loop,
+ * which makes reading from buffers significantly faster.
+ */
+export function promisableLoop({ condition, callback, afterthought = () => void 0, returnValue }) {
+    function iterate() {
+        while (true) {
+            const shouldContinue = condition();
+            if (shouldContinue instanceof Promise)
+                return shouldContinue
+                    .then((shouldContinue) => {
+                    if (shouldContinue) {
+                        const value = callback();
+                        if (value instanceof Promise)
+                            return value.then(() => transformPromisable(afterthought(), iterate));
+                        return transformPromisable(afterthought(), iterate);
+                    }
+                    return returnValue();
+                });
+            if (shouldContinue) {
+                const value = callback();
+                if (value instanceof Promise)
+                    return value.then(() => transformPromisable(afterthought(), iterate));
+                const afterthoughtValue = afterthought();
+                if (afterthoughtValue instanceof Promise)
+                    return afterthoughtValue.then(iterate);
+                continue;
+            }
+            return returnValue();
+        }
+    }
+    return iterate();
+}
+/**
+ * Calls the given getters in order, and when a promise is encountered, waits for it to resolve before continuing.
+ * The result is transformed using the transformer function.
+ *
+ * This is used as a performance optimization to avoid adding many microtasks to the event loop,
+ * which makes reading from buffers significantly faster.
+ * @param getters - An array of functions that return values or promises
+ * @param transformer - The transformer function that takes the promisable values and transforms them into the result of this function
+ */
+export function transformPromisablesInOrder(getters, transformer = ((values) => values)) {
+    let i = 0;
+    const res = [];
+    let skipPushingValue = true;
+    function iterate(currentValue) {
+        if (skipPushingValue)
+            skipPushingValue = false;
+        else
+            res.push(currentValue);
+        while (i < getters.length) {
+            const getter = getters[i];
+            if (getter == null)
+                break;
+            i++;
+            const value = getter();
+            if (value instanceof Promise)
+                return value.then(iterate);
+            res.push(value);
+        }
+        return transformer(res);
+    }
+    return iterate(undefined);
+}
+//# sourceMappingURL=transformPromisable.js.map

package/dist/utils/transformPromisable.js.map

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

package/dist/utils/truncateTextAndRoundToWords.d.ts

@@ -0,0 +1,11 @@
+import { LlamaText } from "./LlamaText.js";
+/**
+ * Truncate the given text starting from the specified index and try to round to the nearest word.
+ * @param text - The text to truncate and round
+ * @param truncateSize - The size of the text to truncate
+ * @param maxRound - The maximum number of extra characters to delete to round to the nearest word
+ * @param truncateStart - Whether to truncate from the start of the text. If false, truncate from the end.
+ * @returns - The truncated and rounded text
+ */
+export declare function truncateTextAndRoundToWords(text: string, truncateSize: number, maxRound?: number, truncateStart?: boolean): string;
+export declare function truncateLlamaTextAndRoundToWords(llamaText: LlamaText, truncateSize: number, maxRound?: number, truncateStart?: boolean): LlamaText;

package/dist/utils/truncateTextAndRoundToWords.js

@@ -0,0 +1,110 @@
+import { LlamaText, SpecialToken } from "./LlamaText.js";
+const truncatePrefix = "...";
+/**
+ * Truncate the given text starting from the specified index and try to round to the nearest word.
+ * @param text - The text to truncate and round
+ * @param truncateSize - The size of the text to truncate
+ * @param maxRound - The maximum number of extra characters to delete to round to the nearest word
+ * @param truncateStart - Whether to truncate from the start of the text. If false, truncate from the end.
+ * @returns - The truncated and rounded text
+ */
+export function truncateTextAndRoundToWords(text, truncateSize, maxRound = 6, truncateStart = false) {
+    if (truncateStart) {
+        const res = text.slice(truncateSize);
+        if (res.length === 0)
+            return res;
+        if (truncateSize === 0 || text[truncateSize - 1] === " ")
+            return res;
+        const nextSpaceIndex = res.indexOf(" ");
+        if (nextSpaceIndex < 0) {
+            if (res.length <= maxRound || res.length < truncatePrefix.length)
+                return "";
+            return truncatePrefix + res.slice(truncatePrefix.length);
+        }
+        if (nextSpaceIndex <= maxRound)
+            return res.slice(nextSpaceIndex + 1);
+        if (res.length < truncatePrefix.length)
+            return "";
+        return truncatePrefix + res.slice(truncatePrefix.length);
+    }
+    else {
+        const res = text.slice(0, -truncateSize);
+        if (res.length === 0)
+            return res;
+        if (truncateSize === 0 || (text.length === res.length || text[res.length] === " "))
+            return res;
+        const nextSpaceIndex = res.lastIndexOf(" ");
+        if (nextSpaceIndex < 0) {
+            if (res.length <= maxRound || res.length < truncatePrefix.length)
+                return "";
+            return res.slice(truncatePrefix.length) + truncatePrefix;
+        }
+        if (nextSpaceIndex <= maxRound)
+            return res.slice(0, nextSpaceIndex);
+        if (res.length < truncatePrefix.length)
+            return "";
+        return res.slice(truncatePrefix.length) + truncatePrefix;
+    }
+}
+export function truncateLlamaTextAndRoundToWords(llamaText, truncateSize, maxRound = 6, truncateStart = false) {
+    if (truncateSize <= 0)
+        return llamaText;
+    if (truncateStart) {
+        for (let i = 0; i < llamaText.values.length; i++) {
+            const value = llamaText.values[i];
+            if (value == null)
+                continue;
+            if (typeof value === "string") {
+                if (value.length > truncateSize) {
+                    return LlamaText([
+                        truncateTextAndRoundToWords(value, truncateSize, maxRound, true),
+                        ...llamaText.values.slice(i + 1)
+                    ]);
+                }
+                truncateSize -= value.length;
+            }
+            else if (value instanceof SpecialToken) {
+                truncateSize--;
+                if (truncateSize <= 0)
+                    return LlamaText(llamaText.values.slice(i + 1));
+            }
+            else {
+                void value;
+                // SpecialTokensText shouldn't be truncated
+                if (value.value.length > truncateSize)
+                    return LlamaText(llamaText.values.slice(i + 1));
+                truncateSize -= value.value.length;
+            }
+        }
+    }
+    else {
+        for (let i = llamaText.values.length - 1; i >= 0; i--) {
+            const value = llamaText.values[i];
+            if (value == null)
+                continue;
+            if (typeof value === "string") {
+                if (value.length > truncateSize) {
+                    return LlamaText([
+                        ...llamaText.values.slice(0, i),
+                        truncateTextAndRoundToWords(value, truncateSize, maxRound, false)
+                    ]);
+                }
+                truncateSize -= value.length;
+            }
+            else if (value instanceof SpecialToken) {
+                truncateSize--;
+                if (truncateSize <= 0)
+                    return LlamaText(llamaText.values.slice(0, i));
+            }
+            else {
+                void value;
+                // SpecialTokensText shouldn't be truncated
+                if (value.value.length > truncateSize)
+                    return LlamaText(llamaText.values.slice(0, i));
+                truncateSize -= value.value.length;
+            }
+        }
+    }
+    return LlamaText([]);
+}
+//# sourceMappingURL=truncateTextAndRoundToWords.js.map

package/dist/utils/truncateTextAndRoundToWords.js.map

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

package/dist/utils/utilTypes.d.ts

@@ -0,0 +1,18 @@
+export type Writable<T> = {
+    -readonly [P in keyof T]: T[P];
+};
+/**
+ * Omit all the keys from `Value` that are not present in `Options` and are `true`.
+ *
+ * For example:
+ * ```ts
+ * type Value = {a: number, b: string, c: boolean};
+ * type Options = {a: true, b: false, c: true};
+ * type Result = PickOptions<Value, Options>; // {a: number, c: boolean}
+ * ```
+ */
+export type PickOptions<Value extends Readonly<Record<string, any>>, Options extends {
+    readonly [key: string]: boolean | undefined;
+}> = Pick<Value, {
+    [Key in keyof Value]: Key extends keyof Options ? Options[Key] extends true ? Key : never : never;
+}[keyof Value]>;

package/dist/utils/utilTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=utilTypes.js.map

package/dist/utils/utilTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilTypes.js","sourceRoot":"","sources":["../../src/utils/utilTypes.ts"],"names":[],"mappings":""}

package/dist/utils/waitForLockfileRelease.d.ts

@@ -0,0 +1,5 @@
+export declare function waitForLockfileRelease({ resourcePath, checkInterval, staleDuration }: {
+    resourcePath: string;
+    checkInterval?: number;
+    staleDuration?: number;
+}): Promise<void>;

package/dist/utils/waitForLockfileRelease.js

@@ -0,0 +1,19 @@
+import lockfile from "proper-lockfile";
+import { isLockActive, waitForLockRelease } from "lifecycle-utils";
+import { lockfileLockScope } from "./withLockfile.js";
+export async function waitForLockfileRelease({ resourcePath, checkInterval = 1000 * 5.5, staleDuration = 1000 * 10 }) {
+    while (true) {
+        if (isLockActive([lockfileLockScope, resourcePath])) {
+            await waitForLockRelease([lockfileLockScope, resourcePath]);
+            continue;
+        }
+        const lockfileActive = await lockfile.check(resourcePath, { stale: staleDuration, realpath: false });
+        const lockIsActive = isLockActive([lockfileLockScope, resourcePath]);
+        if (lockIsActive)
+            continue;
+        if (!lockfileActive)
+            return;
+        await new Promise((resolve) => setTimeout(resolve, checkInterval));
+    }
+}
+//# sourceMappingURL=waitForLockfileRelease.js.map

package/dist/utils/waitForLockfileRelease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForLockfileRelease.js","sourceRoot":"","sources":["../../src/utils/waitForLockfileRelease.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAC,YAAY,EAAE,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EACzC,YAAY,EAAE,aAAa,GAAG,IAAI,GAAG,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,EAAE,EAGtE;IACG,OAAO,IAAI,EAAE,CAAC;QACV,IAAI,YAAY,CAAC,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC;YAClD,MAAM,kBAAkB,CAAC,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC,CAAC;YAC5D,SAAS;QACb,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,EAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC,CAAC;QACnG,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC,CAAC;QAErE,IAAI,YAAY;YACZ,SAAS;QAEb,IAAI,CAAC,cAAc;YACf,OAAO;QAEX,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IACvE,CAAC;AACL,CAAC"}

package/dist/utils/withLockfile.d.ts

@@ -0,0 +1,7 @@
+export declare const lockfileLockScope: {};
+export declare function withLockfile<const T>({ resourcePath, staleDuration, updateInterval, retries }: {
+    resourcePath: string;
+    staleDuration?: number;
+    updateInterval?: number;
+    retries?: number;
+}, callback: () => T | Promise<T>): Promise<T>;