langfx.js 0.1.0-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export * from './errors.js';
+export * from './message.js';
+export * from './template.js';
+export * from './schema.js';
+export * from './language-model.js';
+export * from './query.js';
+export * from './langfunc.js';
+export * from './agentic.js';
+export * from './tool-call.js';
+export * from './tools.js';
+export * as llms from './llms/index.js';
+export type { JsonPath, JsonStreamEvent, StructuredStreamEvent } from './json-stream.js';
+export { Cache, InMemoryCache } from './cache.js';
+export type { InMemoryCacheOptions } from './cache.js';
+export type { RetryOptions } from './retry.js';
+export { Mapping, LfQuery, MappingExample, MappingError } from './mapping.js';
+export type { MappingOptions, MappingExampleOptions } from './mapping.js';
+export * as python from './python.js';

package/dist/index.js

@@ -0,0 +1,15 @@
+export * from './errors.js';
+export * from './message.js';
+export * from './template.js';
+export * from './schema.js';
+export * from './language-model.js';
+export * from './query.js';
+export * from './langfunc.js';
+export * from './agentic.js';
+export * from './tool-call.js';
+export * from './tools.js';
+export * as llms from './llms/index.js';
+export { Cache, InMemoryCache } from './cache.js';
+export { Mapping, LfQuery, MappingExample, MappingError } from './mapping.js';
+export * as python from './python.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAExC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG9E,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC"}

package/dist/json-stream.d.ts

@@ -0,0 +1,73 @@
+import type { SamplingUsage } from './language-model.js';
+export type JsonPath = readonly (string | number)[];
+/** Values in progress are unvalidated. Only generationComplete carries T. */
+export type StructuredStreamEvent<T> = JsonStreamEvent | {
+    readonly type: 'textDelta';
+    readonly delta: string;
+} | {
+    readonly type: 'generationComplete';
+    readonly result: T;
+    readonly usage?: SamplingUsage;
+    readonly finishReason?: string;
+} | {
+    readonly type: 'parsingFailed';
+    readonly error: unknown;
+} | {
+    readonly type: 'generationFailed';
+    readonly error: unknown;
+} | {
+    readonly type: 'cancelled';
+    readonly error: unknown;
+};
+export type JsonStreamEvent = {
+    readonly type: 'objectStart';
+    readonly path: JsonPath;
+    readonly kind: 'object' | 'array';
+    readonly pythonClass?: string;
+    readonly pythonKind?: 'tuple' | 'set';
+} | {
+    readonly type: 'objectEnd';
+    readonly path: JsonPath;
+    readonly kind: 'object' | 'array';
+    readonly value: unknown;
+    readonly pythonKind?: 'tuple' | 'set';
+} | {
+    readonly type: 'fieldStart';
+    readonly path: JsonPath;
+} | {
+    readonly type: 'stringFieldDelta';
+    readonly path: JsonPath;
+    readonly delta: string;
+} | {
+    readonly type: 'fieldEnd';
+    readonly path: JsonPath;
+    readonly value: unknown;
+};
+/** Incremental strict JSON parser. No eval, reparsing prefixes, or schema coercion. */
+export declare class JsonStreamParser {
+    private readonly maxChars;
+    private readonly maxDepth;
+    private readonly stack;
+    private token;
+    private mode;
+    private isKey;
+    private escaped;
+    private unicode;
+    private pendingHigh;
+    private stringValue;
+    private tokenPath;
+    private started;
+    private done;
+    private count;
+    private result;
+    constructor(maxChars?: number, maxDepth?: number);
+    feed(text: string): Generator<JsonStreamEvent>;
+    finish(): Generator<JsonStreamEvent>;
+    get value(): unknown;
+    private beginString;
+    private decoded;
+    private emitDecoded;
+    private finishAtom;
+    private close;
+    private complete;
+}

package/dist/json-stream.js

@@ -0,0 +1,222 @@
+/** Incremental strict JSON parser. No eval, reparsing prefixes, or schema coercion. */
+export class JsonStreamParser {
+    maxChars;
+    maxDepth;
+    stack = [];
+    token = '';
+    mode;
+    isKey = false;
+    escaped = false;
+    unicode;
+    pendingHigh = '';
+    stringValue = '';
+    tokenPath = [];
+    started = false;
+    done = false;
+    count = 0;
+    result;
+    constructor(maxChars = 1_048_576, maxDepth = 64) {
+        this.maxChars = maxChars;
+        this.maxDepth = maxDepth;
+        for (const [name, value] of [['maxChars', maxChars], ['maxDepth', maxDepth]]) {
+            if (!Number.isSafeInteger(value) || value < 1)
+                throw new RangeError(`${name} must be a positive safe integer.`);
+        }
+    }
+    *feed(text) {
+        this.count += text.length;
+        if (this.count > this.maxChars)
+            throw new SyntaxError('Structured output exceeds maxChars.');
+        for (let i = 0; i < text.length; i++) {
+            const c = text[i];
+            if (this.mode === 'string') {
+                if (this.unicode !== undefined) {
+                    if (!/[0-9a-fA-F]/.test(c))
+                        throw new SyntaxError('Invalid JSON Unicode escape.');
+                    this.unicode += c;
+                    if (this.unicode.length === 4) {
+                        yield* this.decoded(String.fromCharCode(parseInt(this.unicode, 16)));
+                        this.unicode = undefined;
+                    }
+                }
+                else if (this.escaped) {
+                    this.escaped = false;
+                    if (c === 'u')
+                        this.unicode = '';
+                    else {
+                        const escapes = { '"': '"', '\\': '\\', '/': '/', b: '\b', f: '\f', n: '\n', r: '\r', t: '\t' };
+                        if (!Object.hasOwn(escapes, c))
+                            throw new SyntaxError('Invalid JSON escape.');
+                        yield* this.decoded(escapes[c]);
+                    }
+                }
+                else if (c === '\\')
+                    this.escaped = true;
+                else if (c === '"') {
+                    if (this.pendingHigh) {
+                        yield* this.emitDecoded(this.pendingHigh);
+                        this.pendingHigh = '';
+                    }
+                    this.mode = undefined;
+                    if (this.isKey) {
+                        const frame = this.stack.at(-1);
+                        if (frame.keys.has(this.stringValue))
+                            throw new SyntaxError('Duplicate JSON object key.');
+                        frame.keys.add(this.stringValue);
+                        frame.key = this.stringValue;
+                        frame.state = 'colon';
+                    }
+                    else
+                        yield* this.complete(this.stringValue, this.tokenPath);
+                }
+                else {
+                    if (c.charCodeAt(0) < 32)
+                        throw new SyntaxError('Unescaped control character in JSON string.');
+                    yield* this.decoded(c);
+                }
+                continue;
+            }
+            if (this.mode === 'atom') {
+                if (!/[\x20\t\r\n,\]}]/.test(c)) {
+                    this.token += c;
+                    continue;
+                }
+                yield* this.finishAtom();
+                // Process this delimiter again, now that the primitive is complete.
+            }
+            if (/[\x20\t\r\n]/.test(c))
+                continue;
+            if (this.done)
+                throw new SyntaxError('Trailing content after JSON value.');
+            const frame = this.stack.at(-1);
+            if (frame?.state === 'commaOrEnd') {
+                if (c === ',') {
+                    frame.state = frame.kind === 'object' ? 'key' : 'value';
+                    continue;
+                }
+                if (c === (frame.kind === 'object' ? '}' : ']')) {
+                    yield* this.close();
+                    continue;
+                }
+                throw new SyntaxError('Expected comma or closing delimiter.');
+            }
+            if (frame?.state === 'colon') {
+                if (c !== ':')
+                    throw new SyntaxError('Expected colon after JSON key.');
+                frame.state = 'value';
+                continue;
+            }
+            if (frame?.state === 'keyOrEnd' || frame?.state === 'key') {
+                if (c === '}' && frame.state === 'keyOrEnd') {
+                    yield* this.close();
+                    continue;
+                }
+                if (c !== '"')
+                    throw new SyntaxError('Expected JSON object key.');
+                this.beginString(true, []);
+                continue;
+            }
+            if (frame?.state === 'valueOrEnd' && c === ']') {
+                yield* this.close();
+                continue;
+            }
+            const path = Object.freeze(frame ? [...frame.path, frame.kind === 'object' ? frame.key : frame.index] : []);
+            if (!frame && this.started)
+                throw new SyntaxError('Unexpected JSON value.');
+            this.started = true;
+            if (path.length)
+                yield { type: 'fieldStart', path };
+            if (c === '{' || c === '[') {
+                if (this.stack.length >= this.maxDepth)
+                    throw new SyntaxError('Structured output exceeds maxDepth.');
+                const kind = c === '{' ? 'object' : 'array';
+                this.stack.push({ kind, path, value: kind === 'object' ? {} : [], state: kind === 'object' ? 'keyOrEnd' : 'valueOrEnd', key: '', index: 0, keys: new Set() });
+                yield { type: 'objectStart', path, kind };
+            }
+            else if (c === '"')
+                this.beginString(false, path);
+            else if (/[\-0-9tfn]/.test(c)) {
+                this.mode = 'atom';
+                this.token = c;
+                this.tokenPath = path;
+            }
+            else
+                throw new SyntaxError('Expected JSON value.');
+        }
+    }
+    *finish() {
+        if (this.mode === 'atom')
+            yield* this.finishAtom();
+        if (!this.done || this.mode || this.stack.length)
+            throw new SyntaxError('Incomplete JSON output.');
+    }
+    get value() {
+        if (!this.done)
+            throw new SyntaxError('JSON value is incomplete.');
+        return this.result;
+    }
+    beginString(isKey, path) {
+        this.mode = 'string';
+        this.isKey = isKey;
+        this.tokenPath = path;
+        this.stringValue = '';
+        this.pendingHigh = '';
+    }
+    *decoded(c) {
+        if (this.pendingHigh) {
+            const high = this.pendingHigh;
+            this.pendingHigh = '';
+            if (/^[\uDC00-\uDFFF]$/.test(c)) {
+                yield* this.emitDecoded(high + c);
+                return;
+            }
+            yield* this.emitDecoded(high);
+        }
+        if (/^[\uD800-\uDBFF]$/.test(c))
+            this.pendingHigh = c;
+        else
+            yield* this.emitDecoded(c);
+    }
+    *emitDecoded(value) {
+        this.stringValue += value;
+        if (!this.isKey)
+            yield { type: 'stringFieldDelta', path: this.tokenPath, delta: value };
+    }
+    *finishAtom() {
+        if (!/^(?:true|false|null|-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?)$/.test(this.token))
+            throw new SyntaxError('Invalid JSON primitive.');
+        const value = JSON.parse(this.token);
+        if (typeof value === 'number' && !Number.isFinite(value))
+            throw new SyntaxError('JSON number exceeds finite range.');
+        this.mode = undefined;
+        this.token = '';
+        yield* this.complete(value, this.tokenPath);
+    }
+    *close() {
+        const frame = this.stack.pop();
+        Object.freeze(frame.value);
+        yield { type: 'objectEnd', path: frame.path, kind: frame.kind, value: frame.value };
+        yield* this.complete(frame.value, frame.path);
+    }
+    *complete(value, path) {
+        // Containers never change after publication; partial events cannot mutate final validation input.
+        if (value !== null && typeof value === 'object')
+            Object.freeze(value);
+        const parent = this.stack.at(-1);
+        if (parent) {
+            if (parent.kind === 'array')
+                parent.value.push(value);
+            else
+                Object.defineProperty(parent.value, parent.key, { value, enumerable: true, writable: true, configurable: true });
+            parent.index++;
+            parent.state = 'commaOrEnd';
+        }
+        else {
+            this.result = value;
+            this.done = true;
+        }
+        if (path.length)
+            yield { type: 'fieldEnd', path, value };
+    }
+}
+//# sourceMappingURL=json-stream.js.map

package/dist/json-stream.js.map

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

package/dist/langfunc.d.ts

@@ -0,0 +1,20 @@
+import { Template } from './template.js';
+import type { Variables } from './template.js';
+import type { Message } from './message.js';
+import type { LanguageModel, CallOptions, StreamChunk } from './language-model.js';
+export interface LangFuncOptions {
+    readonly lm?: LanguageModel;
+    readonly vars?: Variables;
+}
+export interface LangFuncCallOptions extends CallOptions {
+    readonly lm?: LanguageModel;
+    readonly vars?: Variables;
+}
+export declare class LangFunc extends Template {
+    readonly lm: LanguageModel | undefined;
+    constructor(templateOrOptions?: string | LangFuncOptions, options?: LangFuncOptions);
+    transformInput(message: Message): Message;
+    transformOutput(message: Message): Message;
+    call(options?: LangFuncCallOptions): Promise<Message>;
+    stream(options?: LangFuncCallOptions): AsyncIterable<StreamChunk>;
+}

package/dist/langfunc.js

@@ -0,0 +1,28 @@
+import { Template } from './template.js';
+export class LangFunc extends Template {
+    lm;
+    constructor(templateOrOptions, options = {}) {
+        const config = typeof templateOrOptions === 'object' ? templateOrOptions : options;
+        super(typeof templateOrOptions === 'string' ? templateOrOptions : undefined, config.vars);
+        this.lm = config.lm;
+    }
+    transformInput(message) { return message; }
+    transformOutput(message) { return message; }
+    async call(options = {}) {
+        const { lm = this.lm, vars, ...sampling } = options;
+        if (!lm)
+            throw new TypeError('LangFunc.call requires a LanguageModel.');
+        return this.transformOutput(await lm.call(this.transformInput(this.render(vars)), sampling));
+    }
+    stream(options = {}) {
+        const { lm = this.lm, vars, ...sampling } = options;
+        if (!lm)
+            throw new TypeError('LangFunc.stream requires a LanguageModel.');
+        // A whole-message transform cannot safely be applied to independent deltas.
+        if (this.transformOutput !== LangFunc.prototype.transformOutput) {
+            throw new TypeError('LangFunc streaming with transformOutput is not supported yet; use call().');
+        }
+        return lm.stream(this.transformInput(this.render(vars)), sampling);
+    }
+}
+//# sourceMappingURL=langfunc.js.map

package/dist/langfunc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langfunc.js","sourceRoot":"","sources":["../src/langfunc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAOzC,MAAM,OAAO,QAAS,SAAQ,QAAQ;IAC3B,EAAE,CAA4B;IACvC,YAAY,iBAA4C,EAAE,OAAO,GAAoB,EAAE;QACrF,MAAM,MAAM,GAAG,OAAO,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC;QACnF,KAAK,CAAC,OAAO,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1F,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;IACtB,CAAC;IACD,cAAc,CAAC,OAAgB,IAAa,OAAO,OAAO,CAAC,CAAC,CAAC;IAC7D,eAAe,CAAC,OAAgB,IAAa,OAAO,OAAO,CAAC,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,OAAO,GAAwB,EAAE;QAC1C,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC;QACpD,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,CAAC,OAAO,GAAwB,EAAE;QACtC,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC;QACpD,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;QAC1E,4EAA4E;QAC5E,IAAI,IAAI,CAAC,eAAe,KAAK,QAAQ,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;YAChE,MAAM,IAAI,SAAS,CAAC,2EAA2E,CAAC,CAAC;QACnG,CAAC;QACD,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC;CACF"}

package/dist/language-model.d.ts

@@ -0,0 +1,78 @@
+import type { Cache } from './cache.js';
+import type { RetryOptions } from './retry.js';
+import type { ToolDeclaration, ToolCallStreamEvent } from './tool-call.js';
+import { Message } from './message.js';
+export interface SamplingOptions {
+    readonly tools?: readonly ToolDeclaration[];
+    readonly toolChoice?: 'auto' | 'any' | 'none' | {
+        readonly name: string;
+    };
+    readonly temperature?: number;
+    readonly maxTokens?: number;
+    readonly responseSchema?: Readonly<Record<string, unknown>>;
+}
+export interface CallOptions extends SamplingOptions, RetryOptions {
+    readonly cache?: Cache | null;
+    readonly cacheSeed?: number | null;
+    readonly cacheNamespace?: string;
+    readonly signal?: AbortSignal;
+}
+export interface ModelContext extends SamplingOptions {
+    readonly signal: AbortSignal;
+}
+export interface SamplingUsage {
+    readonly promptTokens: number;
+    readonly completionTokens: number;
+    readonly totalTokens: number;
+}
+export interface Sample {
+    readonly response: Message;
+}
+export interface SamplingResult {
+    readonly cacheHit?: boolean;
+    readonly cachedUsage?: SamplingUsage;
+    readonly samples: readonly Sample[];
+    readonly usage?: SamplingUsage;
+}
+export interface StreamChunk {
+    readonly toolEvent?: ToolCallStreamEvent;
+    readonly delta: Message;
+    readonly aggregated: Message;
+    readonly index: number;
+    readonly isFinal: boolean;
+    readonly usage?: SamplingUsage;
+    readonly finishReason?: string;
+}
+export interface ModelCapabilities {
+    readonly streaming: boolean;
+    readonly tools?: boolean;
+    readonly toolStreaming?: boolean;
+    readonly nativeStructuredOutput: boolean;
+    readonly media: boolean;
+}
+export interface LanguageModelOptions extends Omit<CallOptions, 'signal'> {
+    readonly model?: string;
+}
+export declare abstract class LanguageModel {
+    private readonly resultCache;
+    private readonly responseCache;
+    readonly modelId: string;
+    readonly cache: Cache | null;
+    private readonly cacheScope;
+    private readonly runtimeOptions;
+    readonly samplingOptions: Readonly<SamplingOptions>;
+    readonly capabilities: ModelCapabilities;
+    constructor(options?: LanguageModelOptions);
+    protected abstract _sample(prompts: readonly Message[], context: ModelContext): Promise<readonly SamplingResult[]>;
+    protected _stream(_prompt: Message, _context: ModelContext): AsyncIterable<StreamChunk>;
+    sample(prompts: readonly (string | Message)[], options?: CallOptions): Promise<SamplingResult[]>;
+    call(prompt: string | Message, options?: CallOptions): Promise<Message>;
+    /** Evict the exact entry associated with a response from this model's call(). */
+    invalidateCache(response: Message): Promise<void>;
+    /** Always returns an async iterable directly, never a Promise. */
+    stream(prompt: string | Message, options?: CallOptions): AsyncIterable<StreamChunk>;
+    private sampleAttempt;
+    private validateResults;
+    private context;
+    private validate;
+}