@boundaryml/baml-bridge-web 0.0.0

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import { BamlCallContext, BamlRuntime, Collector, HostSpanManager } from "./native.js";
+export { BamlAudio, BamlCallContext, BamlHandle, BamlImage, BamlPdf, BamlRuntime, BamlVideo, Collector, FunctionLog, HostSpanManager, LLMCall, Timing, Usage, flushEvents, getRuntime, getVersion, newFunctionCall } from "./native.js";
+export { BamlStream } from "./shared/stream.js";
+export { BamlTypeMap, getTypeMap, setTypeMap } from "./shared/typemap.js";
+export { defineFunction, defineInstanceFunction, UNSET } from "./shared/define_function.js";
+export type { GenericParams } from "./shared/define_function.js";
+export { Never, lowerTypeToWireTy } from "./shared/wire_ty.js";
+export type { BamlClassCtor, BamlPrimitiveToken, BamlType } from "./shared/wire_ty.js";
+export { BamlAbortError, BamlCancelledError, BamlClientError, BamlError, BamlInvalidArgumentError, BamlPanic } from "./shared/errors.js";
+export { decodeCallResult, encodeCallArgs } from "./shared/proto.js";
+export declare function initializeRuntimeFromBytecode(bytecode: Uint8Array): void;
+export declare function initializeRuntime(srcDir: string, files: Record<string, string>): void;
+export declare class FunctionResult {
+    private readonly value;
+    constructor(value: unknown);
+    result(): unknown;
+    toString(): string;
+}
+export declare function callFunctionSync(rt: BamlRuntime, functionName: string, kwargs: Record<string, unknown>, ctx?: HostSpanManager, collectors?: Collector[], callCtx?: BamlCallContext): FunctionResult;
+export declare function callFunction(rt: BamlRuntime, functionName: string, kwargs: Record<string, unknown>, ctx?: HostSpanManager, collectors?: Collector[], callCtx?: BamlCallContext): Promise<FunctionResult>;
+export declare class CtxManager {
+    private readonly context;
+    get(): HostSpanManager;
+    allowReset(): boolean;
+    reset(): void;
+    cloneContext(): HostSpanManager;
+    upsertTags(tags: Record<string, string>): void;
+}
+export declare function cancelFunctionCall(callId: bigint): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../typescript_src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAwG,MAAM,aAAa,CAAC;AAG7L,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxO,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAC5F,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,SAAS,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACzI,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAErE,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAExE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAErF;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,OAAO;IAC3C,MAAM,IAAI,OAAO;IACjB,QAAQ,IAAI,MAAM;CACnB;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,cAAc,CASnM;AAED,wBAAsB,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAS9M;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,GAAG,IAAI,eAAe;IACtB,UAAU,IAAI,OAAO;IACrB,KAAK,IAAI,IAAI;IACb,YAAY,IAAI,eAAe;IAC/B,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAC/C;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/index.js

@@ -0,0 +1,57 @@
+import { BamlRuntime, HostSpanManager, cancelFunctionCall as nativeCancelFunctionCall, newFunctionCall as nativeNewFunctionCall } from "./native.js";
+import { decodeCallResult, encodeCallArgs } from "./shared/proto.js";
+export { BamlAudio, BamlCallContext, BamlHandle, BamlImage, BamlPdf, BamlRuntime, BamlVideo, Collector, FunctionLog, HostSpanManager, LLMCall, Timing, Usage, flushEvents, getRuntime, getVersion, newFunctionCall } from "./native.js";
+export { BamlStream } from "./shared/stream.js";
+export { BamlTypeMap, getTypeMap, setTypeMap } from "./shared/typemap.js";
+export { defineFunction, defineInstanceFunction, UNSET } from "./shared/define_function.js";
+export { Never, lowerTypeToWireTy } from "./shared/wire_ty.js";
+export { BamlAbortError, BamlCancelledError, BamlClientError, BamlError, BamlInvalidArgumentError, BamlPanic } from "./shared/errors.js";
+export { decodeCallResult, encodeCallArgs } from "./shared/proto.js";
+export function initializeRuntimeFromBytecode(bytecode) {
+    BamlRuntime.initializeRuntimeFromBytecode(bytecode);
+}
+export function initializeRuntime(srcDir, files) {
+    BamlRuntime.initializeRuntime(srcDir, files);
+}
+export class FunctionResult {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    result() { return this.value; }
+    toString() { return `FunctionResult(${JSON.stringify(this.value)})`; }
+}
+export function callFunctionSync(rt, functionName, kwargs, ctx, collectors, callCtx) {
+    const callId = nativeNewFunctionCall();
+    const args = encodeCallArgs(kwargs, { syncMode: true, callId });
+    callCtx?._attachCallId(callId.toString());
+    try {
+        return new FunctionResult(decodeCallResult(rt.callFunctionSync(functionName, args, ctx ?? null, collectors ?? null)));
+    }
+    finally {
+        callCtx?._detachCallId(callId.toString());
+    }
+}
+export async function callFunction(rt, functionName, kwargs, ctx, collectors, callCtx) {
+    const callId = nativeNewFunctionCall();
+    const args = encodeCallArgs(kwargs, { callId });
+    callCtx?._attachCallId(callId.toString());
+    try {
+        return new FunctionResult(decodeCallResult(await rt.callFunction(functionName, args, ctx ?? null, collectors ?? null)));
+    }
+    finally {
+        callCtx?._detachCallId(callId.toString());
+    }
+}
+export class CtxManager {
+    context = new HostSpanManager();
+    get() { return this.context; }
+    allowReset() { return true; }
+    reset() { }
+    cloneContext() { return this.context.deepClone(); }
+    upsertTags(tags) { this.context.upsertTags(tags); }
+}
+export function cancelFunctionCall(callId) {
+    return nativeCancelFunctionCall(callId);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../typescript_src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,WAAW,EAAa,eAAe,EAAE,kBAAkB,IAAI,wBAAwB,EAAc,eAAe,IAAI,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC7L,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxO,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAE5F,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,SAAS,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACzI,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAErE,MAAM,UAAU,6BAA6B,CAAC,QAAoB;IAChE,WAAW,CAAC,6BAA6B,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,KAA6B;IAC7E,WAAW,CAAC,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,KAAc;QAAd,UAAK,GAAL,KAAK,CAAS;IAAG,CAAC;IAC/C,MAAM,KAAc,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,QAAQ,KAAa,OAAO,kBAAkB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/E;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAe,EAAE,YAAoB,EAAE,MAA+B,EAAE,GAAqB,EAAE,UAAwB,EAAE,OAAyB;IACjL,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAChE,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,cAAc,CAAC,gBAAgB,CAAC,EAAE,CAAC,gBAAgB,CAAC,YAAY,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACxH,CAAC;YAAS,CAAC;QACT,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAe,EAAE,YAAoB,EAAE,MAA+B,EAAE,GAAqB,EAAE,UAAwB,EAAE,OAAyB;IACnL,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,cAAc,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1H,CAAC;YAAS,CAAC;QACT,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,MAAM,OAAO,UAAU;IACJ,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;IACjD,GAAG,KAAsB,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,UAAU,KAAc,OAAO,IAAI,CAAC,CAAC,CAAC;IACtC,KAAK,KAAU,CAAC;IAChB,YAAY,KAAsB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACpE,UAAU,CAAC,IAA4B,IAAU,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CAClF;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/native.d.ts

@@ -0,0 +1,79 @@
+export interface HandleKey {
+    low: number;
+    high: number;
+}
+export declare class BamlHandle {
+    readonly key: HandleKey;
+    readonly handleType: number;
+    constructor(key: HandleKey, handleType: number);
+    clone(): BamlHandle;
+    _cloneKeyForWire(): HandleKey;
+}
+declare class BamlMedia {
+    private readonly handle;
+    protected constructor(handle: BamlHandle);
+    static fromUrl(_url: string, _mimeType?: string | null): BamlMedia;
+    static fromFile(_file: string, _mimeType?: string | null): BamlMedia;
+    static fromBase64(_base64: string, _mimeType?: string | null): BamlMedia;
+    static _fromHandle(handle: BamlHandle): BamlMedia;
+    _toHandle(): BamlHandle;
+    url(): string | null;
+    file(): string | null;
+    base64(): string;
+    mimeType(): string | null;
+}
+export declare class BamlImage extends BamlMedia {
+}
+export declare class BamlAudio extends BamlMedia {
+}
+export declare class BamlVideo extends BamlMedia {
+}
+export declare class BamlPdf extends BamlMedia {
+}
+export declare class BamlCallContext {
+    private callIds;
+    private isAborted;
+    abort(): void;
+    get aborted(): boolean;
+    _attachCallId(callId: string): void;
+    _detachCallId(callId: string): void;
+}
+export declare class HostSpanManager {
+    enter(_name: string, _args: unknown): void;
+    exitOk(): void;
+    exitError(_message: string): void;
+    upsertTags(_tags: Record<string, string>): void;
+    deepClone(): HostSpanManager;
+    contextDepth(): number;
+}
+export declare class Timing {
+}
+export declare class Usage {
+}
+export declare class LlmCall {
+}
+export { LlmCall as LLMCall };
+export declare class FunctionLog {
+}
+export declare class Collector {
+    constructor(_name?: string | null);
+}
+export declare class BamlRuntime {
+    static initializeRuntimeFromBytecode(bytecode: Uint8Array): BamlRuntime;
+    static initializeRuntime(_rootPath: string, _files: Record<string, string>): BamlRuntime;
+    callFunctionSync(functionName: string, encodedArgs: Uint8Array, _ctx?: HostSpanManager | null, _collectors?: Collector[] | null): Uint8Array;
+    callFunction(functionName: string, encodedArgs: Uint8Array, _ctx?: HostSpanManager | null, _collectors?: Collector[] | null): Promise<Uint8Array>;
+}
+export declare function getRuntime(): BamlRuntime;
+export declare function newFunctionCall(): bigint;
+export declare function cancelFunctionCall(callId: bigint | string): boolean;
+export declare function flushEvents(): void;
+export declare function getVersion(): string;
+export declare function mintHostValueKey(): HandleKey;
+export declare function registerHostValueReleaseCallback(callback: (key: HandleKey) => void): void;
+export declare function registerHostCallable(callback: (callId: number, args: Uint8Array) => void): HandleKey;
+export declare function releaseHostCallable(key: HandleKey): void;
+export declare function completeHostCall(callId: number, isError: number, content: Uint8Array): void;
+export declare function _seedFunctionRefHandle(_globalIndex: number): [HandleKey, number];
+export declare function _seedGenericMediaHandle(): [HandleKey, number];
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../typescript_src/native.ts"],"names":[],"mappings":"AAuDA,MAAM,WAAW,SAAS;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE;AAMzD,qBAAa,UAAU;aACO,GAAG,EAAE,SAAS;aAAkB,UAAU,EAAE,MAAM;gBAAlD,GAAG,EAAE,SAAS,EAAkB,UAAU,EAAE,MAAM;IAC9E,KAAK,IAAI,UAAU;IACnB,gBAAgB,IAAI,SAAS;CAC9B;AAED,cAAM,SAAS;IACS,OAAO,CAAC,QAAQ,CAAC,MAAM;IAA7C,SAAS,aAA8B,MAAM,EAAE,UAAU;IACzD,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAClE,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IACpE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IACxE,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS;IACjD,SAAS,IAAI,UAAU;IACvB,GAAG,IAAI,MAAM,GAAG,IAAI;IACpB,IAAI,IAAI,MAAM,GAAG,IAAI;IACrB,MAAM,IAAI,MAAM;IAChB,QAAQ,IAAI,MAAM,GAAG,IAAI;CAC1B;AAED,qBAAa,SAAU,SAAQ,SAAS;CAAG;AAC3C,qBAAa,SAAU,SAAQ,SAAS;CAAG;AAC3C,qBAAa,SAAU,SAAQ,SAAS;CAAG;AAC3C,qBAAa,OAAQ,SAAQ,SAAS;CAAG;AAEzC,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAS;IAC1B,KAAK,IAAI,IAAI;IAIb,IAAI,OAAO,IAAI,OAAO,CAA2B;IACjD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKnC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CACpC;AAED,qBAAa,eAAe;IAC1B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAC1C,MAAM,IAAI,IAAI;IACd,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IACjC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAC/C,SAAS,IAAI,eAAe;IAC5B,YAAY,IAAI,MAAM;CACvB;AAED,qBAAa,MAAM;CAAG;AACtB,qBAAa,KAAK;CAAG;AACrB,qBAAa,OAAO;CAAG;AACvB,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,CAAC;AAC9B,qBAAa,WAAW;CAAG;AAC3B,qBAAa,SAAS;gBACR,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;CAClC;AAED,qBAAa,WAAW;IACtB,MAAM,CAAC,6BAA6B,CAAC,QAAQ,EAAE,UAAU,GAAG,WAAW;IAKvE,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW;IAGxF,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,EAAE,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,GAAG,UAAU;IAG5I,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,EAAE,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;CAGlJ;AAKD,wBAAgB,UAAU,IAAI,WAAW,CAGxC;AACD,wBAAgB,eAAe,IAAI,MAAM,CAAkC;AAC3E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAmD;AACvH,wBAAgB,WAAW,IAAI,IAAI,CAAG;AACtC,wBAAgB,UAAU,IAAI,MAAM,CAAwB;AAC5D,wBAAgB,gBAAgB,IAAI,SAAS,CAAiD;AAC9F,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI,CAGzF;AACD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,SAAS,CAA6D;AAClK,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAIxD;AACD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAAmD;AAC/I,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAmE;AACpJ,wBAAgB,uBAAuB,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAmE"}

package/dist/native.js

@@ -0,0 +1,148 @@
+import initWasm, { callFunction as callWasmFunction, callFunctionSync as callWasmFunctionSync, cancelFunctionCall as cancelWasmFunctionCall, completeWebHostCall, mintWebHostValueKey, newFunctionCall as newWasmFunctionCall, registerWebHostCallable, registerWebHostValueReleaseCallback, releaseWebHostCallable, stageRuntimeBytecode, } from "./wasm/bridge_web_core.js";
+await initWasm();
+async function browserFetch(_callId, method, url, headersJson, body) {
+    const headers = JSON.parse(headersJson);
+    const response = await fetch(url, {
+        method,
+        headers,
+        body: body.length === 0 || method === "GET" || method === "HEAD" ? undefined : body,
+    });
+    const responseHeaders = {};
+    response.headers.forEach((value, key) => { responseHeaders[key] = value; });
+    return {
+        status: response.status,
+        headersJson: JSON.stringify(responseHeaders),
+        url: response.url,
+        bodyPromise: response.text(),
+    };
+}
+const unsupportedProcess = async () => {
+    throw new Error("process execution is not available in a browser");
+};
+const browserCallbacks = {
+    fetch: browserFetch,
+    env: (key) => globalThis.BAML_ENV?.[key],
+    input: async (_requestId, promptText) => globalThis.prompt?.(promptText ?? "") ?? "",
+    exec: unsupportedProcess,
+    shell: unsupportedProcess,
+    lsp_send_notification: () => { },
+    lsp_send_response: () => { },
+    lsp_make_request: () => { },
+    playground_send_notification: () => { },
+    host_dispatch: (key) => { throw new Error(`unknown browser host callable ${key}`); },
+};
+function keyFromBigint(value) {
+    return { low: Number(BigInt.asIntN(32, value)), high: Number(BigInt.asIntN(32, value >> 32n)) };
+}
+export class BamlHandle {
+    key;
+    handleType;
+    constructor(key, handleType) {
+        this.key = key;
+        this.handleType = handleType;
+    }
+    clone() { return new BamlHandle(this.key, this.handleType); }
+    _cloneKeyForWire() { return this.key; }
+}
+class BamlMedia {
+    handle;
+    constructor(handle) {
+        this.handle = handle;
+    }
+    static fromUrl(_url, _mimeType) { throw new Error("browser media construction is not implemented yet"); }
+    static fromFile(_file, _mimeType) { throw new Error("browser media construction is not implemented yet"); }
+    static fromBase64(_base64, _mimeType) { throw new Error("browser media construction is not implemented yet"); }
+    static _fromHandle(handle) { return new this(handle); }
+    _toHandle() { return this.handle.clone(); }
+    url() { return null; }
+    file() { return null; }
+    base64() { throw new Error("browser media access is not implemented yet"); }
+    mimeType() { return null; }
+}
+export class BamlImage extends BamlMedia {
+}
+export class BamlAudio extends BamlMedia {
+}
+export class BamlVideo extends BamlMedia {
+}
+export class BamlPdf extends BamlMedia {
+}
+export class BamlCallContext {
+    callIds = new Set();
+    isAborted = false;
+    abort() {
+        this.isAborted = true;
+        for (const callId of this.callIds)
+            cancelWasmFunctionCall(callId);
+    }
+    get aborted() { return this.isAborted; }
+    _attachCallId(callId) {
+        const id = BigInt(callId);
+        this.callIds.add(id);
+        if (this.isAborted)
+            cancelWasmFunctionCall(id);
+    }
+    _detachCallId(callId) { this.callIds.delete(BigInt(callId)); }
+}
+export class HostSpanManager {
+    enter(_name, _args) { }
+    exitOk() { }
+    exitError(_message) { }
+    upsertTags(_tags) { }
+    deepClone() { return new HostSpanManager(); }
+    contextDepth() { return 0; }
+}
+export class Timing {
+}
+export class Usage {
+}
+export class LlmCall {
+}
+export { LlmCall as LLMCall };
+export class FunctionLog {
+}
+export class Collector {
+    constructor(_name) { }
+}
+export class BamlRuntime {
+    static initializeRuntimeFromBytecode(bytecode) {
+        stageRuntimeBytecode(bytecode, browserCallbacks);
+        runtime = new BamlRuntime();
+        return runtime;
+    }
+    static initializeRuntime(_rootPath, _files) {
+        throw new Error("browser source initialization is not implemented; use bytecode");
+    }
+    callFunctionSync(functionName, encodedArgs, _ctx, _collectors) {
+        return callWasmFunctionSync(functionName, encodedArgs);
+    }
+    callFunction(functionName, encodedArgs, _ctx, _collectors) {
+        return callWasmFunction(functionName, encodedArgs);
+    }
+}
+let runtime;
+let hostRelease;
+export function getRuntime() {
+    if (!runtime)
+        throw new Error("BAML runtime has not been initialized");
+    return runtime;
+}
+export function newFunctionCall() { return newWasmFunctionCall(); }
+export function cancelFunctionCall(callId) { return cancelWasmFunctionCall(BigInt(callId)); }
+export function flushEvents() { }
+export function getVersion() { return "0.0.0-web"; }
+export function mintHostValueKey() { return keyFromBigint(mintWebHostValueKey()); }
+export function registerHostValueReleaseCallback(callback) {
+    hostRelease = callback;
+    registerWebHostValueReleaseCallback((key) => hostRelease?.(keyFromBigint(key)));
+}
+export function registerHostCallable(callback) { return keyFromBigint(registerWebHostCallable(callback)); }
+export function releaseHostCallable(key) {
+    const value = BigInt.asUintN(64, BigInt(key.high) << 32n | BigInt.asUintN(32, BigInt(key.low)));
+    releaseWebHostCallable(value);
+    hostRelease?.(key);
+}
+export function completeHostCall(callId, isError, content) { completeWebHostCall(callId, isError, content); }
+export function _seedFunctionRefHandle(_globalIndex) { throw new Error("test handle seeding is not implemented yet"); }
+export function _seedGenericMediaHandle() { throw new Error("test handle seeding is not implemented yet"); }
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

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

package/dist/shared/define_function.d.ts

@@ -0,0 +1,31 @@
+export type Mode = 'sync' | 'async';
+/** Sentinel for "argument not supplied" so optional kwargs can be skipped. */
+export declare const UNSET: unique symbol;
+/**
+ * Generic-binding contract for a callable. `typeParams` are the callee's OWN
+ * `<...>` param names (bound by the caller's `$types` option); `classTypeParams`
+ * are the enclosing generic class's params (bound from the `self` receiver's
+ * `$types` field). Mirrors `define_function`'s `type_params` /
+ * `class_type_params` kwargs in the Python SDK. Omitted/empty ⇒ non-generic.
+ */
+export interface GenericParams {
+    typeParams?: readonly string[];
+    classTypeParams?: readonly string[];
+}
+/**
+ * Factory for a free function or static method binding. Returns a callable
+ * that maps positional args to kwargs, encodes, calls the runtime, and decodes.
+ * `sync` returns the decoded value; `async` returns a `Promise` of it.
+ */
+export declare function defineFunction(bamlFqn: string, mode: Mode, requiredParamNames: readonly string[], optionalParamNames?: readonly string[] | undefined, generics?: GenericParams | undefined): (...args: unknown[]) => unknown;
+/**
+ * Receiver-binding factory for instance methods. `paramNames[0]` is always
+ * `"self"`. Codegen emits the binding as a class-field initializer
+ * `m = defineInstanceFunction(...).bind(this) as () => R;`, so `.bind(self)`
+ * captures the instance at construction time; the synthetic `self` param never
+ * appears in the surface type.
+ */
+export declare function defineInstanceFunction(bamlFqn: string, mode: Mode, requiredParamNames: readonly string[], optionalParamNames?: readonly string[] | undefined, generics?: GenericParams | undefined): {
+    bind(self: unknown): (...args: unknown[]) => unknown;
+};
+//# sourceMappingURL=define_function.d.ts.map

package/dist/shared/define_function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define_function.d.ts","sourceRoot":"","sources":["../../typescript_src/shared/define_function.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpC,8EAA8E;AAC9E,eAAO,MAAM,KAAK,EAAE,OAAO,MAA6B,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC1B,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAoLD;;;;GAIG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,EACV,kBAAkB,EAAE,SAAS,MAAM,EAAE,EACrC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAClD,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,GACrC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CA8CjC;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,EACV,kBAAkB,EAAE,SAAS,MAAM,EAAE,EACrC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAClD,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,GACrC;IAAE,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;CAAE,CA2D1D"}

package/dist/shared/define_function.js

@@ -0,0 +1,274 @@
+// define_function.ts — runtime factories for BAML callables, the Node analog
+// of `define_function` in sdks/python/src/baml_bridge/__init__.py.
+//
+// Generated SDK code emits, per BAML function:
+//   export const f = defineFunction("user.ns.f", "sync", ["a"]) as (a: A) => R;
+//   export const f_async = defineFunction("user.ns.f", "async", ["a"]) as (a: A) => Promise<R>;
+// and per instance method (inside the class body):
+//   m = defineInstanceFunction("user.ns.C.m", "sync", ["self"]).bind(this) as () => R;
+//
+// The factory captures (fqn, mode, requiredNames, optionalNames) by closure;
+// the returned callable zips positional args against requiredNames into kwargs,
+// encodes it, calls the runtime, and decodes the result.
+import { getRuntime, newFunctionCall as nativeNewFunctionCall, } from '../native.js';
+import { encodeCallArgs, decodeCallResult } from './proto.js';
+import { lowerTypeToWireTy } from './wire_ty.js';
+/** Sentinel for "argument not supplied" so optional kwargs can be skipped. */
+export const UNSET = Symbol('baml.UNSET');
+/**
+ * Resolve the caller's `$types` option onto the callee's own generic params, in
+ * declaration order. Mirrors Python's `_resolve_types_kwarg`: `$types` is an
+ * object keyed by param name and is required iff the callee declares its own
+ * generic params; it must bind exactly those params (no missing, no extras).
+ */
+function resolveTypesOption(typesOpt, typeParams) {
+    if (typeParams.length === 0) {
+        if (typesOpt !== undefined && typesOpt !== null) {
+            throw new TypeError('$types is not accepted here: this function/method declares no generic type ' +
+                'parameters of its own');
+        }
+        return [];
+    }
+    const example = `{ ${JSON.stringify(typeParams[0])}: 'int' }`;
+    if (typesOpt === undefined || typesOpt === null) {
+        throw new TypeError(`$types is required for this generic call: bind every type parameter in ` +
+            `${JSON.stringify(typeParams)} with an object, e.g. $types: ${example}`);
+    }
+    if (typeof typesOpt !== 'object' || Array.isArray(typesOpt)) {
+        throw new TypeError(`$types must be an object mapping type-parameter names to types (e.g. ` +
+            `$types: ${example}); got ${typeof typesOpt}`);
+    }
+    const obj = typesOpt;
+    const missing = typeParams.filter((n) => !(n in obj));
+    if (missing.length) {
+        throw new TypeError(`$types is missing binding(s) for ${JSON.stringify(missing)}: every type parameter ` +
+            `in ${JSON.stringify(typeParams)} must be bound.`);
+    }
+    const extra = Object.keys(obj).filter((k) => !typeParams.includes(k));
+    if (extra.length) {
+        throw new TypeError(`$types has unknown type parameter(s) ${JSON.stringify(extra)}; expected exactly ` +
+            `${JSON.stringify(typeParams)}.`);
+    }
+    return typeParams.map((n) => obj[n]);
+}
+/** The `$types` field of a generic receiver instance (its class TypeVar
+ * bindings), or `undefined` when the receiver carries none. The TS analog of
+ * Python's `pydantic_instance_type_args(self)`. */
+function receiverTypes(self) {
+    if (self != null && typeof self === 'object') {
+        const t = self.$types;
+        if (t != null && typeof t === 'object') {
+            return t;
+        }
+    }
+    return undefined;
+}
+/**
+ * Build the named, order-preserving wire `type_args` for a generic call. Mirrors
+ * Python's `_build_type_args`: enclosing class params (recovered from the `self`
+ * receiver's `$types`) come first, then the callee's own params (`$types`
+ * option) — De Bruijn order. Class params are seeded only when the receiver
+ * actually carries them, so a non-generic receiver keeps the engine's
+ * recover-from-receiver behavior. Returns `[]` when the call binds nothing.
+ */
+function buildTypeArgs(self, typesOpt, typeParams, classTypeParams) {
+    const wire = [];
+    const classTypes = classTypeParams.length ? receiverTypes(self) : undefined;
+    if (classTypes) {
+        for (const name of classTypeParams) {
+            wire.push([name, lowerTypeToWireTy(classTypes[name])]);
+        }
+    }
+    const resolved = resolveTypesOption(typesOpt, typeParams);
+    if (typeParams.length > 0) {
+        if (classTypeParams.length && !classTypes) {
+            // The method's own params sit after the class prefix in De Bruijn
+            // order; without recovered class args we can't position them.
+            throw new TypeError('$types on a generic method requires a generic receiver carrying its class type ' +
+                'args (a `$types` field on the instance)');
+        }
+        typeParams.forEach((name, i) => {
+            wire.push([name, lowerTypeToWireTy(resolved[i])]);
+        });
+    }
+    return wire;
+}
+function newFunctionCall() {
+    return BigInt(nativeNewFunctionCall());
+}
+function attachCallContext(ctx, callId) {
+    ctx?._attachCallId(callId.toString());
+    return {
+        detach() {
+            ctx?._detachCallId(callId.toString());
+        },
+    };
+}
+function buildArgs(args, requiredParamNames, optionalParamNames) {
+    const positionalLimit = requiredParamNames.length;
+    if (args.length > positionalLimit + 1) {
+        throw new TypeError(`got ${args.length} positional arguments but only ${positionalLimit} positional ` +
+            `parameter names (${JSON.stringify(requiredParamNames)})`);
+    }
+    const built = {};
+    for (let i = 0; i < args.length && i < positionalLimit; i++) {
+        if (args[i] === UNSET)
+            continue;
+        built[requiredParamNames[i]] = args[i];
+    }
+    let ctx;
+    let types;
+    if (args.length > positionalLimit) {
+        const opts = args[positionalLimit];
+        if (opts === undefined || opts === UNSET) {
+            return { kwargs: built };
+        }
+        if (opts === null || Array.isArray(opts) || typeof opts !== 'object') {
+            throw new TypeError('optional arguments must be passed as an object');
+        }
+        const optionNames = new Set(optionalParamNames);
+        for (const [key, value] of Object.entries(opts)) {
+            if (key === '$ctx') {
+                if (value !== undefined && value !== UNSET) {
+                    ctx = value;
+                }
+                continue;
+            }
+            if (key === '$types') {
+                // Generic-call TypeVar bindings — captured here and lowered to
+                // wire `type_args` by the factory, never sent as a kwarg value.
+                if (value !== undefined && value !== UNSET) {
+                    types = value;
+                }
+                continue;
+            }
+            if (!optionNames.has(key)) {
+                throw new TypeError(`unknown optional argument ${JSON.stringify(key)}`);
+            }
+            if (value === undefined || value === UNSET)
+                continue;
+            built[key] = value;
+        }
+    }
+    return { kwargs: built, ctx, types };
+}
+/**
+ * Factory for a free function or static method binding. Returns a callable
+ * that maps positional args to kwargs, encodes, calls the runtime, and decodes.
+ * `sync` returns the decoded value; `async` returns a `Promise` of it.
+ */
+export function defineFunction(bamlFqn, mode, requiredParamNames, optionalParamNames, generics) {
+    const requiredNames = [...requiredParamNames];
+    const optionNames = [...(optionalParamNames ?? [])];
+    // A free function / static method binds only its OWN generic params (a
+    // generic receiver is never in play here), so `classTypeParams` is unused.
+    const typeParams = generics?.typeParams ?? [];
+    const isGeneric = typeParams.length > 0;
+    // Eagerly reject `$types` on a non-generic call, matching the generic path's
+    // strict binding contract (mirrors Python's `is_generic` gate).
+    const typeArgsFor = (built) => isGeneric ? buildTypeArgs(undefined, built.types, typeParams, []) : [];
+    if (mode === 'sync') {
+        return (...args) => {
+            const built = buildArgs(args, requiredNames, optionNames);
+            const typeArgs = typeArgsFor(built);
+            const rt = getRuntime();
+            const callId = newFunctionCall();
+            const argsProto = encodeCallArgs(built.kwargs, { syncMode: true, callId, typeArgs });
+            const callCtxBinding = attachCallContext(built.ctx, callId);
+            let resultBytes;
+            try {
+                resultBytes = rt.callFunctionSync(bamlFqn, argsProto, null, null);
+            }
+            finally {
+                callCtxBinding.detach();
+            }
+            return decodeCallResult(resultBytes);
+        };
+    }
+    if (mode === 'async') {
+        return async (...args) => {
+            const built = buildArgs(args, requiredNames, optionNames);
+            const typeArgs = typeArgsFor(built);
+            const rt = getRuntime();
+            const callId = newFunctionCall();
+            const argsProto = encodeCallArgs(built.kwargs, { callId, typeArgs });
+            const callCtxBinding = attachCallContext(built.ctx, callId);
+            let resultBytes;
+            try {
+                resultBytes = await rt.callFunction(bamlFqn, argsProto, null, null);
+            }
+            finally {
+                callCtxBinding.detach();
+            }
+            return decodeCallResult(resultBytes);
+        };
+    }
+    throw new Error(`mode must be 'sync' or 'async', got ${JSON.stringify(mode)}`);
+}
+/**
+ * Receiver-binding factory for instance methods. `paramNames[0]` is always
+ * `"self"`. Codegen emits the binding as a class-field initializer
+ * `m = defineInstanceFunction(...).bind(this) as () => R;`, so `.bind(self)`
+ * captures the instance at construction time; the synthetic `self` param never
+ * appears in the surface type.
+ */
+export function defineInstanceFunction(bamlFqn, mode, requiredParamNames, optionalParamNames, generics) {
+    const requiredNames = [...requiredParamNames];
+    const optionNames = [...(optionalParamNames ?? [])];
+    const selfName = requiredNames[0] ?? 'self';
+    const rest = requiredNames.slice(1);
+    // An instance method binds its own `<...>` params (caller's `$types`) AND
+    // the enclosing class's params, recovered from the `self` receiver's
+    // `$types` field. Mirrors Python's `class_type_params` for instance methods.
+    const typeParams = generics?.typeParams ?? [];
+    const classTypeParams = generics?.classTypeParams ?? [];
+    const isGeneric = typeParams.length > 0 || classTypeParams.length > 0;
+    const makeArgs = (self, args) => {
+        const built = buildArgs(args, rest, optionNames);
+        built.kwargs[selfName] = self;
+        return built;
+    };
+    return {
+        bind(self) {
+            const typeArgsFor = (built) => isGeneric ? buildTypeArgs(self, built.types, typeParams, classTypeParams) : [];
+            if (mode === 'sync') {
+                return (...args) => {
+                    const built = makeArgs(self, args);
+                    const typeArgs = typeArgsFor(built);
+                    const rt = getRuntime();
+                    const callId = newFunctionCall();
+                    const argsProto = encodeCallArgs(built.kwargs, { syncMode: true, callId, typeArgs });
+                    const callCtxBinding = attachCallContext(built.ctx, callId);
+                    let resultBytes;
+                    try {
+                        resultBytes = rt.callFunctionSync(bamlFqn, argsProto, null, null);
+                    }
+                    finally {
+                        callCtxBinding.detach();
+                    }
+                    return decodeCallResult(resultBytes);
+                };
+            }
+            if (mode === 'async') {
+                return async (...args) => {
+                    const built = makeArgs(self, args);
+                    const typeArgs = typeArgsFor(built);
+                    const rt = getRuntime();
+                    const callId = newFunctionCall();
+                    const argsProto = encodeCallArgs(built.kwargs, { callId, typeArgs });
+                    const callCtxBinding = attachCallContext(built.ctx, callId);
+                    let resultBytes;
+                    try {
+                        resultBytes = await rt.callFunction(bamlFqn, argsProto, null, null);
+                    }
+                    finally {
+                        callCtxBinding.detach();
+                    }
+                    return decodeCallResult(resultBytes);
+                };
+            }
+            throw new Error(`mode must be 'sync' or 'async', got ${JSON.stringify(mode)}`);
+        },
+    };
+}
+//# sourceMappingURL=define_function.js.map