modaic 0.1.0

package/esm/signatures/signature.js

@@ -0,0 +1,222 @@
+import { z } from "zod";
+/**
+ * A Signature defines the interface for a DSPy-style predictor.
+ * It includes optional instructions, an input schema, and an output schema.
+ * Both input and output are defined using Zod schemas.
+ *
+ * This is a port of the `@modaic/dsts` Signature with tool support removed —
+ * Arbiters are pure judges and never call tools.
+ */
+export class Signature {
+    instructions;
+    input;
+    output;
+    prefixes = {};
+    constructor(sig) {
+        this.instructions =
+            sig.instructions ||
+                this.generateDefaultInstructions(sig.input, sig.output);
+        this.input = sig.input;
+        this.output = sig.output;
+        // Initialize default prefixes
+        const allFields = { ...sig.input.shape, ...sig.output.shape };
+        for (const name in allFields) {
+            this.prefixes[name] = infer_prefix(name) + ":";
+        }
+    }
+    generateDefaultInstructions(input, output) {
+        const inputFields = Object.keys(input.shape);
+        const outputFields = Object.keys(output.shape);
+        const inputStr = inputFields.map((f) => `\`${f}\``).join(", ");
+        const outputStr = outputFields.map((f) => `\`${f}\``).join(", ");
+        return `Given the fields ${inputStr}, produce the fields ${outputStr}.`;
+    }
+    get input_fields() {
+        return this.input.shape;
+    }
+    get output_fields() {
+        return this.output.shape;
+    }
+    /**
+     * Static helper to create a Signature from a string definition.
+     * e.g. Signature.parse("question -> answer", "Answer the question.")
+     */
+    static parse(sigStr, instructions) {
+        const parsed = parseStringSignature(sigStr);
+        return new Signature({
+            instructions,
+            input: parsed.input,
+            output: parsed.output,
+        });
+    }
+    /**
+     * Returns a new Signature with the specified field removed from either input or output.
+     */
+    delete(inputOrOutput, name) {
+        const inputShape = this.input.shape;
+        const outputShape = this.output.shape;
+        let newInput = this.input;
+        let newOutput = this.output;
+        // Remove from input if present and requested
+        if (name in inputShape && inputOrOutput === "input") {
+            newInput = this.input.omit({ [name]: true });
+        }
+        // Remove from output if present and requested
+        if (name in outputShape && inputOrOutput === "output") {
+            newOutput = this.output.omit({
+                [name]: true,
+            });
+        }
+        return new Signature({
+            instructions: this.instructions,
+            input: newInput,
+            output: newOutput,
+        });
+    }
+    /**
+     * Returns a new Signature with updated instructions.
+     */
+    withInstructions(instructions) {
+        return new Signature({
+            instructions,
+            input: this.input,
+            output: this.output,
+        });
+    }
+    dump_state() {
+        const fields = Object.entries({
+            ...this.input.shape,
+            ...this.output.shape,
+        }).map(([name, field]) => ({
+            prefix: this.prefixes[name],
+            description: field.meta?.()?.description ||
+                field.meta?.()?.desc ||
+                field._def?.description ||
+                "",
+        }));
+        return {
+            instructions: this.instructions,
+            fields,
+        };
+    }
+    load_state(state) {
+        const prefixToName = {};
+        for (const [name, prefix] of Object.entries(this.prefixes)) {
+            prefixToName[prefix] = name;
+        }
+        const inputPatch = {};
+        const outputPatch = {};
+        for (const fieldState of state.fields) {
+            const name = prefixToName[fieldState.prefix];
+            if (!name)
+                continue;
+            const isInput = name in this.input.shape;
+            const field = (isInput ? this.input.shape[name] : this.output.shape[name]);
+            let updatedField = field;
+            const description = fieldState.description;
+            updatedField = updatedField.describe(description);
+            if (typeof updatedField.meta === "function") {
+                const currentMeta = updatedField.meta() || {};
+                updatedField = updatedField.meta({
+                    ...currentMeta,
+                    description,
+                    desc: description,
+                });
+            }
+            if (isInput) {
+                inputPatch[name] = updatedField;
+            }
+            else {
+                outputPatch[name] = updatedField;
+            }
+        }
+        return new Signature({
+            instructions: state.instructions,
+            input: this.input.extend(inputPatch),
+            output: this.output.extend(outputPatch),
+        });
+    }
+}
+/**
+ * Maps common string type names to Zod schemas.
+ */
+const mapTypeToZod = (typeStr) => {
+    switch (typeStr?.toLowerCase()) {
+        case "number":
+            return z.number();
+        case "boolean":
+            return z.boolean();
+        case "string":
+        case undefined:
+        case "":
+            return z.string();
+        default:
+            // Default to string for unknown types, similar to DSPy behavior
+            return z.string();
+    }
+};
+/**
+ * Parses a string-based signature like "input1: string, input2: number -> output: string"
+ */
+const parseStringSignature = (sigStr) => {
+    const parts = sigStr.split("->");
+    if (parts.length !== 2) {
+        throw new Error(`Invalid signature string: "${sigStr}". Must contain exactly one "->" separator.`);
+    }
+    const [inputsPart, outputsPart] = parts.map((s) => s.trim());
+    const parsePart = (part) => {
+        const shape = {};
+        const fields = part
+            .split(",")
+            .map((f) => f.trim())
+            .filter(Boolean);
+        for (const field of fields) {
+            const [name, type] = field.split(":").map((s) => s.trim());
+            if (!name)
+                continue;
+            shape[name] = mapTypeToZod(type);
+        }
+        return z.object(shape);
+    };
+    return {
+        input: parsePart(inputsPart),
+        output: parsePart(outputsPart),
+    };
+};
+/**
+ * Infer a prefix from an attribute name by converting it to a human-readable format.
+ * Matches the logic in DSPy's infer_prefix.
+ *
+ * Examples:
+ *   "camelCaseText" -> "Camel Case Text"
+ *   "snake_case_text" -> "Snake Case Text"
+ *   "text2number" -> "Text 2 Number"
+ *   "HTMLParser" -> "HTML Parser"
+ */
+export function infer_prefix(attributeName) {
+    // Step 1: Convert camelCase to snake_case
+    // Example: "camelCase" -> "camel_Case"
+    const s1 = attributeName.replace(/(.)([A-Z][a-z]+)/g, "$1_$2");
+    // Handle consecutive capitals
+    // Example: "camel_Case" -> "camel_case"
+    const intermediateName = s1.replace(/([a-z0-9])([A-Z])/g, "$1_$2");
+    // Step 2: Handle numbers by adding underscores around them
+    // Example: "text2number" -> "text_2_number"
+    let withUnderscoresAroundNumbers = intermediateName.replace(/([a-zA-Z])(\d)/g, "$1_$2");
+    // Example: "2text" -> "2_text"
+    withUnderscoresAroundNumbers = withUnderscoresAroundNumbers.replace(/(\d)([a-zA-Z])/g, "$1_$2");
+    // Step 3: Convert to Title Case while preserving acronyms
+    const words = withUnderscoresAroundNumbers.split("_");
+    const titleCasedWords = words.map((word) => {
+        if (word === word.toUpperCase() && word !== word.toLowerCase()) {
+            // Preserve acronyms like 'HTML', 'API' as-is
+            return word;
+        }
+        // Capitalize first letter: 'text' -> 'Text'
+        return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+    });
+    // Join words with spaces
+    // Example: ["Text", "2", "Number"] -> "Text 2 Number"
+    return titleCasedWords.join(" ");
+}
+//# sourceMappingURL=signature.js.map

package/esm/signatures/signature.js.map

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

package/esm/signatures/types.d.ts

@@ -0,0 +1,69 @@
+import { z } from "zod";
+/**
+ * Special signature field types — the modaic-ts analogs of dspy's custom types.
+ *
+ * These are how a Signature declares a field that is more than a plain primitive.
+ * Each one is detected by the serializer (`src/serialization/zod_schema.ts`) via a
+ * `__modaic_type` marker on the field's Zod `.meta()`, and is serialized into the
+ * exact JSON the Python SDK produces — so an Arbiter authored here round-trips into
+ * the right Python type with **no Python-side changes**:
+ *
+ *   - `Image` / `Audio`  -> `$defs["Image"] = {"type":"dspy.Image"}` + a `$ref` field,
+ *                           which the Python SDK reconstructs as a real `dspy.Image` /
+ *                           `dspy.Audio` (its adapters already render them multimodally).
+ *   - `Scale(lo, hi)`    -> a plain integer enum `{"enum":[lo..hi], "type":"integer"}`,
+ *                           matching Python `modaic.Scale[lo, hi]`.
+ *   - `Enum(...values)`  -> a plain string enum `{"enum":[...], "type":"string"}`,
+ *                           matching Python `modaic.Enum[...]`.
+ */
+/** Marker value the serializer reads from a field's `.meta().__modaic_type`. */
+export type ModaicTypeTag = "image" | "audio" | "scale";
+/**
+ * `modaic.Image` — a multimodal image field, the TS analog of `dspy.Image`.
+ *
+ * Use {@link Image.field} inside a `Signature`'s input/output schema, and construct
+ * `new Image({ url })` to carry a value when calling `predict`.
+ */
+export declare class Image {
+    url: string;
+    constructor(init: {
+        url: string;
+    });
+    /**
+     * The Zod schema to place in a `Signature`. Serializes to a `dspy.Image` `$ref`.
+     * Chain `.describe(...)` to set the field description.
+     */
+    static field(): z.ZodType;
+}
+/**
+ * `modaic.Audio` — a multimodal audio field, the TS analog of `dspy.Audio`.
+ *
+ * Use {@link Audio.field} inside a `Signature`'s input/output schema, and construct
+ * `new Audio({ url })` to carry a value when calling `predict`.
+ */
+export declare class Audio {
+    url: string;
+    constructor(init: {
+        url: string;
+    });
+    /**
+     * The Zod schema to place in a `Signature`. Serializes to a `dspy.Audio` `$ref`.
+     * Chain `.describe(...)` to set the field description.
+     */
+    static field(): z.ZodType;
+}
+/**
+ * `modaic.Scale(lo, hi)` — an integer rating in `[lo, hi]` inclusive.
+ *
+ * Serializes to a plain integer enum `{"enum":[lo, lo+1, …, hi], "type":"integer"}`,
+ * matching Python `modaic.Scale[lo, hi]` (which presents to the model as a Literal of ints).
+ */
+export declare function Scale(lo: number, hi: number): z.ZodType;
+/**
+ * `modaic.Enum(...values)` — a string choice from a fixed set.
+ *
+ * Serializes to `{"enum":[...], "type":"string"}` (a single value serializes as
+ * `{"const": v, "type":"string"}`), matching Python `modaic.Enum[...]`.
+ */
+export declare function Enum<T extends string>(...values: [T, ...T[]]): z.ZodType;
+//# sourceMappingURL=types.d.ts.map

package/esm/signatures/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/signatures/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;GAgBG;AAEH,gFAAgF;AAChF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAExD;;;;;GAKG;AACH,qBAAa,KAAK;IAChB,GAAG,EAAE,MAAM,CAAC;IAEZ,YAAY,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,EAEhC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAExB;CACF;AAED;;;;;GAKG;AACH,qBAAa,KAAK;IAChB,GAAG,EAAE,MAAM,CAAC;IAEZ,YAAY,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,EAEhC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAExB;CACF;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAYvD;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAExE"}

package/esm/signatures/types.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+/**
+ * `modaic.Image` — a multimodal image field, the TS analog of `dspy.Image`.
+ *
+ * Use {@link Image.field} inside a `Signature`'s input/output schema, and construct
+ * `new Image({ url })` to carry a value when calling `predict`.
+ */
+export class Image {
+    url;
+    constructor(init) {
+        this.url = init.url;
+    }
+    /**
+     * The Zod schema to place in a `Signature`. Serializes to a `dspy.Image` `$ref`.
+     * Chain `.describe(...)` to set the field description.
+     */
+    static field() {
+        return z.custom().meta({ __modaic_type: "image" });
+    }
+}
+/**
+ * `modaic.Audio` — a multimodal audio field, the TS analog of `dspy.Audio`.
+ *
+ * Use {@link Audio.field} inside a `Signature`'s input/output schema, and construct
+ * `new Audio({ url })` to carry a value when calling `predict`.
+ */
+export class Audio {
+    url;
+    constructor(init) {
+        this.url = init.url;
+    }
+    /**
+     * The Zod schema to place in a `Signature`. Serializes to a `dspy.Audio` `$ref`.
+     * Chain `.describe(...)` to set the field description.
+     */
+    static field() {
+        return z.custom().meta({ __modaic_type: "audio" });
+    }
+}
+/**
+ * `modaic.Scale(lo, hi)` — an integer rating in `[lo, hi]` inclusive.
+ *
+ * Serializes to a plain integer enum `{"enum":[lo, lo+1, …, hi], "type":"integer"}`,
+ * matching Python `modaic.Scale[lo, hi]` (which presents to the model as a Literal of ints).
+ */
+export function Scale(lo, hi) {
+    if (!Number.isInteger(lo) || !Number.isInteger(hi)) {
+        throw new Error("Scale values must be integers");
+    }
+    if (lo > hi) {
+        throw new Error(`Scale lo (${lo}) must be <= hi (${hi})`);
+    }
+    return z
+        .int()
+        .gte(lo)
+        .lte(hi)
+        .meta({ __modaic_type: "scale", lo, hi });
+}
+/**
+ * `modaic.Enum(...values)` — a string choice from a fixed set.
+ *
+ * Serializes to `{"enum":[...], "type":"string"}` (a single value serializes as
+ * `{"const": v, "type":"string"}`), matching Python `modaic.Enum[...]`.
+ */
+export function Enum(...values) {
+    return z.enum(values);
+}
+//# sourceMappingURL=types.js.map

package/esm/signatures/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/signatures/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuBxB;;;;;GAKG;AACH,MAAM,OAAO,KAAK;IAChB,GAAG,CAAS;IAEZ,YAAY,IAAqB,EAAE;QACjC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IAAA,CACrB;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,GAAc;QACxB,OAAO,CAAC,CAAC,MAAM,EAAS,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;IAAA,CAC3D;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,KAAK;IAChB,GAAG,CAAS;IAEZ,YAAY,IAAqB,EAAE;QACjC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IAAA,CACrB;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,GAAc;QACxB,OAAO,CAAC,CAAC,MAAM,EAAS,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;IAAA,CAC3D;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU,EAAE,EAAU,EAAa;IACvD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,oBAAoB,EAAE,GAAG,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,CAAC;SACL,GAAG,EAAE;SACL,GAAG,CAAC,EAAE,CAAC;SACP,GAAG,CAAC,EAAE,CAAC;SACP,IAAI,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAAA,CAC7C;AAED;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAmB,GAAG,MAAmB,EAAa;IACxE,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAAA,CACvB"}

package/esm/types/async.d.ts

@@ -0,0 +1,23 @@
+export type APICall = {
+    status: "complete";
+    request: Request;
+    response: Response;
+} | {
+    status: "request-error";
+    request: Request;
+    response?: undefined;
+} | {
+    status: "invalid";
+    request?: undefined;
+    response?: undefined;
+};
+export declare class APIPromise<T> implements Promise<T> {
+    #private;
+    readonly [Symbol.toStringTag] = "APIPromise";
+    constructor(p: [T, APICall] | Promise<[T, APICall]>);
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null | undefined): Promise<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null | undefined): Promise<T | TResult>;
+    finally(onfinally?: (() => void) | null | undefined): Promise<T>;
+    $inspect(): Promise<[T, APICall]>;
+}
+//# sourceMappingURL=async.d.ts.map

package/esm/types/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../src/types/async.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,OAAO,GACf;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACpB,GACD;IACE,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEN,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,OAAO,CAAC,CAAC,CAAC;;IAI9C,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,gBAAgB;IAE7C,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAGlD;IAMD,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,EACjC,WAAW,CAAC,EACR,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAChD,IAAI,GACJ,SAAS,EACb,UAAU,CAAC,EACP,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GACnD,IAAI,GACJ,SAAS,GACZ,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAK9B;IAED,KAAK,CAAC,OAAO,GAAG,KAAK,EACnB,UAAU,CAAC,EACP,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,GACjD,IAAI,GACJ,SAAS,GACZ,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,CAEtB;IAED,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAE/D;IAED,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAEhC;CACF"}

package/esm/types/async.js

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+export class APIPromise {
+    #promise;
+    #unwrapped;
+    [Symbol.toStringTag] = "APIPromise";
+    constructor(p) {
+        this.#promise = p instanceof Promise ? p : Promise.resolve(p);
+        this.#unwrapped = p instanceof Promise ? null : Promise.resolve(p[0]);
+    }
+    #getUnwrapped() {
+        return (this.#unwrapped ?? (this.#unwrapped = this.#promise.then(([value]) => value)));
+    }
+    then(onfulfilled, onrejected) {
+        return this.#promise.then(onfulfilled ? ([value]) => onfulfilled(value) : void 0, onrejected);
+    }
+    catch(onrejected) {
+        return this.#getUnwrapped().catch(onrejected);
+    }
+    finally(onfinally) {
+        return this.#getUnwrapped().finally(onfinally);
+    }
+    $inspect() {
+        return this.#promise;
+    }
+}
+//# sourceMappingURL=async.js.map

package/esm/types/async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.js","sourceRoot":"","sources":["../../src/types/async.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,MAAM,OAAO,UAAU;IACZ,QAAQ,CAAwB;IACzC,UAAU,CAAoB;IAErB,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,YAAY,CAAC;IAE7C,YAAY,CAAuC,EAAE;QACnD,IAAI,CAAC,QAAQ,GAAG,CAAC,YAAY,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,GAAG,CAAC,YAAY,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAAA,CACvE;IAED,aAAa,GAAe;QAC1B,OAAO,CAAC,IAAI,CAAC,UAAU,KAAf,IAAI,CAAC,UAAU,GAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAC,CAAC;IAAA,CACrE;IAED,IAAI,CACF,WAGa,EACb,UAGa,EACiB;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CACvB,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EACtD,UAAU,CACX,CAAC;IAAA,CACH;IAED,KAAK,CACH,UAGa,EACS;QACtB,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAAA,CAC/C;IAED,OAAO,CAAC,SAA2C,EAAc;QAC/D,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAAA,CAChD;IAED,QAAQ,GAA0B;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC;IAAA,CACtB;CACF"}

package/esm/types/blobs.d.ts

@@ -0,0 +1,4 @@
+import * as z from "zod/v4-mini";
+export declare const blobLikeSchema: z.ZodMiniType<Blob, Blob>;
+export declare function isBlobLike(val: unknown): val is Blob;
+//# sourceMappingURL=blobs.d.ts.map

package/esm/types/blobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blobs.d.ts","sourceRoot":"","sources":["../../src/types/blobs.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAMpD,CAAC;AAEF,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,IAAI,CAkBpD"}

package/esm/types/blobs.js

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+export const blobLikeSchema = z.custom(isBlobLike, {
+    message: "expected a Blob, File or Blob-like object",
+    abort: true,
+});
+export function isBlobLike(val) {
+    if (val instanceof Blob) {
+        return true;
+    }
+    if (typeof val !== "object" || val == null || !(Symbol.toStringTag in val)) {
+        return false;
+    }
+    const name = val[Symbol.toStringTag];
+    if (typeof name !== "string") {
+        return false;
+    }
+    if (name !== "Blob" && name !== "File") {
+        return false;
+    }
+    return "stream" in val && typeof val.stream === "function";
+}
+//# sourceMappingURL=blobs.js.map

package/esm/types/blobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blobs.js","sourceRoot":"","sources":["../../src/types/blobs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC,MAAM,CAAC,MAAM,cAAc,GAA8B,CAAC,CAAC,MAAM,CAC/D,UAAU,EACV;IACE,OAAO,EAAE,2CAA2C;IACpD,KAAK,EAAE,IAAI;CACZ,CACF,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,GAAY,EAAe;IACpD,IAAI,GAAG,YAAY,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,WAAW,IAAI,GAAG,CAAC,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,QAAQ,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC;AAAA,CAC5D"}

package/esm/types/const-date-time.d.ts

@@ -0,0 +1,3 @@
+import * as z from "zod/v4-mini";
+export declare function constDateTime(val: string): z.ZodMiniType<string, unknown>;
+//# sourceMappingURL=const-date-time.d.ts.map

package/esm/types/const-date-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"const-date-time.d.ts","sourceRoot":"","sources":["../../src/types/const-date-time.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,GACV,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAMhC"}

package/esm/types/const-date-time.js

@@ -0,0 +1,10 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+export function constDateTime(val) {
+    return z.custom((v) => {
+        return (typeof v === "string" && new Date(v).getTime() === new Date(val).getTime());
+    }, `Value must be equivalent to ${val}`);
+}
+//# sourceMappingURL=const-date-time.js.map

package/esm/types/const-date-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const-date-time.js","sourceRoot":"","sources":["../../src/types/const-date-time.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC,MAAM,UAAU,aAAa,CAC3B,GAAW,EACqB;IAChC,OAAO,CAAC,CAAC,MAAM,CAAS,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7B,OAAO,CACL,OAAO,CAAC,KAAK,QAAQ,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAC3E,CAAC;IAAA,CACH,EAAE,+BAA+B,GAAG,EAAE,CAAC,CAAC;AAAA,CAC1C"}

package/esm/types/default-to-zero-value.d.ts

@@ -0,0 +1,12 @@
+import { type Unrecognized } from "./unrecognized.js";
+export declare function defaultToZeroValue<T>(value: T): Unrecognized<T>;
+export declare function startCountingDefaultToZeroValue(): {
+    /**
+     * Ends counting and returns the delta.
+     * @param delta - If provided, only this amount is added to the parent counter
+     *   (used for nested unions where we only want to record the winning option's count).
+     *   If not provided, records all counts since start().
+     */
+    end: (delta?: number | undefined) => number;
+};
+//# sourceMappingURL=default-to-zero-value.d.ts.map

package/esm/types/default-to-zero-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-to-zero-value.d.ts","sourceRoot":"","sources":["../../src/types/default-to-zero-value.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,mBAAmB,CAAC;AAKpE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAG/D;AAED,wBAAgB,+BAA+B;IAI3C;;;;;OAKG;;EASN"}

package/esm/types/default-to-zero-value.js

@@ -0,0 +1,31 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import { unrecognized } from "./unrecognized.js";
+let globalCount = 0;
+let refCount = 0;
+export function defaultToZeroValue(value) {
+    globalCount++;
+    return unrecognized(value);
+}
+export function startCountingDefaultToZeroValue() {
+    refCount++;
+    const start = globalCount;
+    return {
+        /**
+         * Ends counting and returns the delta.
+         * @param delta - If provided, only this amount is added to the parent counter
+         *   (used for nested unions where we only want to record the winning option's count).
+         *   If not provided, records all counts since start().
+         */
+        end: (delta) => {
+            const count = globalCount - start;
+            // Reset globalCount back to start, then add only the specified delta
+            globalCount = start + (delta ?? count);
+            if (--refCount === 0)
+                globalCount = 0;
+            return count;
+        },
+    };
+}
+//# sourceMappingURL=default-to-zero-value.js.map

package/esm/types/default-to-zero-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-to-zero-value.js","sourceRoot":"","sources":["../../src/types/default-to-zero-value.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAqB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEpE,IAAI,WAAW,GAAG,CAAC,CAAC;AACpB,IAAI,QAAQ,GAAG,CAAC,CAAC;AAEjB,MAAM,UAAU,kBAAkB,CAAI,KAAQ,EAAmB;IAC/D,WAAW,EAAE,CAAC;IACd,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;AAAA,CAC5B;AAED,MAAM,UAAU,+BAA+B,GAAG;IAChD,QAAQ,EAAE,CAAC;IACX,MAAM,KAAK,GAAG,WAAW,CAAC;IAC1B,OAAO;QACL;;;;;WAKG;QACH,GAAG,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,WAAW,GAAG,KAAK,CAAC;YAClC,qEAAqE;YACrE,WAAW,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;YACvC,IAAI,EAAE,QAAQ,KAAK,CAAC;gBAAE,WAAW,GAAG,CAAC,CAAC;YACtC,OAAO,KAAK,CAAC;QAAA,CACd;KACF,CAAC;AAAA,CACH"}

package/esm/types/enums.d.ts

@@ -0,0 +1,9 @@
+import * as z from "zod/v4-mini";
+import { Unrecognized } from "./unrecognized.js";
+export type ClosedEnum<T extends Readonly<Record<string, string | number>>> = T[keyof T];
+export type OpenEnum<T extends Readonly<Record<string, string | number>>> = T[keyof T] | Unrecognized<T[keyof T] extends number ? number : string>;
+export declare function inboundSchema<T extends Record<string, string>>(enumObj: T): z.ZodMiniType<OpenEnum<T>, unknown>;
+export declare function inboundSchemaInt<T extends Record<string, number | string>>(enumObj: T): z.ZodMiniType<OpenEnum<T>, unknown>;
+export declare function outboundSchema<T extends Record<string, string>>(_: T): z.ZodMiniType<string, OpenEnum<T>>;
+export declare function outboundSchemaInt<T extends Record<string, number | string>>(_: T): z.ZodMiniType<number, OpenEnum<T>>;
+//# sourceMappingURL=enums.d.ts.map

package/esm/types/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/types/enums.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,YAAY,EAAgB,MAAM,mBAAmB,CAAC;AAE/D,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,IACxE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AACb,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,IACpE,CAAC,CAAC,MAAM,CAAC,CAAC,GACV,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;AAE9D,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5D,OAAO,EAAE,CAAC,GACT,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAMrC;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EACxE,OAAO,EAAE,CAAC,GACT,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAOrC;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7D,CAAC,EAAE,CAAC,GACH,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAEpC;AAED,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EACzE,CAAC,EAAE,CAAC,GACH,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAEpC"}

package/esm/types/enums.js

@@ -0,0 +1,27 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+import { unrecognized } from "./unrecognized.js";
+export function inboundSchema(enumObj) {
+    const options = Object.values(enumObj);
+    return z.union([
+        ...options.map(x => z.literal(x)),
+        z.pipe(z.string(), z.transform(x => unrecognized(x))),
+    ]);
+}
+export function inboundSchemaInt(enumObj) {
+    // For numeric enums, Object.values returns both numbers and string keys
+    const options = Object.values(enumObj).filter(v => typeof v === "number");
+    return z.union([
+        ...options.map(x => z.literal(x)),
+        z.pipe(z.int(), z.transform(x => unrecognized(x))),
+    ]);
+}
+export function outboundSchema(_) {
+    return z.string();
+}
+export function outboundSchemaInt(_) {
+    return z.int();
+}
+//# sourceMappingURL=enums.js.map

package/esm/types/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/types/enums.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EAAgB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAQ/D,MAAM,UAAU,aAAa,CAC3B,OAAU,EAC2B;IACrC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC,KAAK,CAAC;QACb,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;KAC/C,CAAC,CAAC;AAAA,CACX;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAU,EAC2B;IACrC,wEAAwE;IACxE,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IAC1E,OAAO,CAAC,CAAC,KAAK,CAAC;QACb,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;KAC5C,CAAC,CAAC;AAAA,CACX;AAED,MAAM,UAAU,cAAc,CAC5B,CAAI,EACgC;IACpC,OAAO,CAAC,CAAC,MAAM,EAAS,CAAC;AAAA,CAC1B;AAED,MAAM,UAAU,iBAAiB,CAC/B,CAAI,EACgC;IACpC,OAAO,CAAC,CAAC,GAAG,EAAS,CAAC;AAAA,CACvB"}

package/esm/types/fp.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A monad that captures the result of a function call or an error if it was not
+ * successful. Railway programming, enabled by this type, can be a nicer
+ * alternative to traditional exception throwing because it allows functions to
+ * declare all _known_ errors with static types and then check for them
+ * exhaustively in application code. Thrown exception have a type of `unknown`
+ * and break out of regular control flow of programs making them harder to
+ * inspect and more verbose work with due to try-catch blocks.
+ */
+export type Result<T, E = unknown> = {
+    ok: true;
+    value: T;
+    error?: never;
+} | {
+    ok: false;
+    value?: never;
+    error: E;
+};
+export declare function OK<V>(value: V): Result<V, never>;
+export declare function ERR<E>(error: E): Result<never, E>;
+/**
+ * unwrap is a convenience function for extracting a value from a result or
+ * throwing if there was an error.
+ */
+export declare function unwrap<T>(r: Result<T, unknown>): T;
+/**
+ * unwrapAsync is a convenience function for resolving a value from a Promise
+ * of a result or rejecting if an error occurred.
+ */
+export declare function unwrapAsync<T>(pr: Promise<Result<T, unknown>>): Promise<T>;
+//# sourceMappingURL=fp.d.ts.map

package/esm/types/fp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fp.d.ts","sourceRoot":"","sources":["../../src/types/fp.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,IAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GACrC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAE3C,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAEhD;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAEjD;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAKlD;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC,CAOZ"}