modaic 0.1.0

package/esm/modaic/git.js.map

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

package/esm/modaic/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The modaic library layer — a git client + Modaic API client that turns zod
+ * Signatures into the canonical `config.json` / `program.json` format shared with
+ * the Python SDK and Modaic Hub.
+ *
+ * This is hand-written and lives alongside the generated Speakeasy REST SDK. The
+ * package root (`src/main.ts`) re-exports both.
+ */
+export { Signature, infer_prefix, Image, Audio, Scale, Enum } from "./signatures.js";
+export type { InferInput, InferOutput, ModaicTypeTag } from "./signatures.js";
+export { Arbiter, ensure_reasoning_field } from "./arbiter.js";
+export type { ArbiterOptions, CreateOptions, UpdateOptions, PredictOptions, } from "./arbiter.js";
+export { serializeSignatureToConfig, buildProgramJson, lmStateFromModel, repoNameToTitle, serializeField, fieldDesc, pydanticTitle, sortSchema, } from "./serialization.js";
+export type { ConfigJson, ConfigField, ProgramJson, LMState, JsonSchema, FieldInfo, } from "./serialization.js";
+export { syncAndPush, createRepo, getUserInfo } from "./git.js";
+export type { Commit, PushFiles, SyncAndPushOptions, UserInfo } from "./git.js";
+export type { PredictExampleResponse } from "../models/index.js";
+export { getApiUrl, getGitUrl, resolveToken, getCacheDir, stagingDir, ModaicError, AuthenticationError, RepositoryNotFoundError, RepositoryExistsError, } from "./runtime.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/modaic/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modaic/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACrF,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG9E,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,SAAS,EACT,aAAa,EACb,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,OAAO,EACP,UAAU,EACV,SAAS,GACV,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAChE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGhF,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,EACL,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,cAAc,CAAC"}

package/esm/modaic/index.js

@@ -0,0 +1,19 @@
+/**
+ * The modaic library layer — a git client + Modaic API client that turns zod
+ * Signatures into the canonical `config.json` / `program.json` format shared with
+ * the Python SDK and Modaic Hub.
+ *
+ * This is hand-written and lives alongside the generated Speakeasy REST SDK. The
+ * package root (`src/main.ts`) re-exports both.
+ */
+// Signatures & special field types
+export { Signature, infer_prefix, Image, Audio, Scale, Enum } from "./signatures.js";
+// Arbiter (high-level judge API)
+export { Arbiter, ensure_reasoning_field } from "./arbiter.js";
+// Serialization — the canonical config.json / program.json format
+export { serializeSignatureToConfig, buildProgramJson, lmStateFromModel, repoNameToTitle, serializeField, fieldDesc, pydanticTitle, sortSchema, } from "./serialization.js";
+// Git + hub client (git-host REST calls that aren't part of the typed SDK)
+export { syncAndPush, createRepo, getUserInfo } from "./git.js";
+// Runtime — config helpers + error hierarchy
+export { getApiUrl, getGitUrl, resolveToken, getCacheDir, stagingDir, ModaicError, AuthenticationError, RepositoryNotFoundError, RepositoryExistsError, } from "./runtime.js";
+//# sourceMappingURL=index.js.map

package/esm/modaic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modaic/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mCAAmC;AACnC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAGrF,iCAAiC;AACjC,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAQ/D,kEAAkE;AAClE,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,SAAS,EACT,aAAa,EACb,UAAU,GACX,MAAM,oBAAoB,CAAC;AAU5B,2EAA2E;AAC3E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAMhE,6CAA6C;AAC7C,OAAO,EACL,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,cAAc,CAAC"}

package/esm/modaic/runtime.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Base error for all Modaic library failures.
+ *
+ * Note: the generated Speakeasy SDK has its own unrelated HTTP-transport base
+ * error, renamed to `ModaicClientError` via `baseErrorName` in gen.yaml so the
+ * two never clash. This `ModaicError` is the library's domain-error base.
+ */
+export declare class ModaicError extends Error {
+    constructor(message: string);
+}
+/**
+ * Raised when no access token is available, or the token is rejected by the hub.
+ */
+export declare class AuthenticationError extends ModaicError {
+    constructor(message: string);
+}
+/**
+ * Raised when a repository that is expected to exist cannot be found on the hub.
+ */
+export declare class RepositoryNotFoundError extends ModaicError {
+    constructor(message: string);
+}
+/**
+ * Raised when creating a repository that already exists and `exist_ok` is false.
+ */
+export declare class RepositoryExistsError extends ModaicError {
+    constructor(message: string);
+}
+/**
+ * Base URL of the Modaic REST API. Mirrors the Python SDK default.
+ */
+export declare function getApiUrl(): string;
+/**
+ * Base URL of the Modaic git host. Mirrors the Python SDK default.
+ */
+export declare function getGitUrl(): string;
+/**
+ * Resolve the access token: explicit arg first, then the MODAIC_TOKEN env var.
+ * Throws if neither is set.
+ */
+export declare function resolveToken(accessToken?: string | null): string;
+/**
+ * Root cache directory used for staging git clones. Defaults to
+ * `~/.cache/modaic-ts`; override with the `MODAIC_CACHE` environment variable.
+ */
+export declare function getCacheDir(): string;
+/**
+ * Local staging directory for a repo's git working tree, keyed by "owner/name".
+ */
+export declare function stagingDir(repo: string): string;
+//# sourceMappingURL=runtime.d.ts.map

package/esm/modaic/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/modaic/runtime.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,WAAW;IACtD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,WAAW;IACpD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAUD;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAIlC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAIlC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAQhE;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAIpC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/esm/modaic/runtime.js

@@ -0,0 +1,88 @@
+import os from "node:os";
+import path from "node:path";
+/* -------------------------------------------------------------------------- */
+/*  Errors                                                                     */
+/* -------------------------------------------------------------------------- */
+/**
+ * Base error for all Modaic library failures.
+ *
+ * Note: the generated Speakeasy SDK has its own unrelated HTTP-transport base
+ * error, renamed to `ModaicClientError` via `baseErrorName` in gen.yaml so the
+ * two never clash. This `ModaicError` is the library's domain-error base.
+ */
+export class ModaicError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ModaicError";
+    }
+}
+/**
+ * Raised when no access token is available, or the token is rejected by the hub.
+ */
+export class AuthenticationError extends ModaicError {
+    constructor(message) {
+        super(message);
+        this.name = "AuthenticationError";
+    }
+}
+/**
+ * Raised when a repository that is expected to exist cannot be found on the hub.
+ */
+export class RepositoryNotFoundError extends ModaicError {
+    constructor(message) {
+        super(message);
+        this.name = "RepositoryNotFoundError";
+    }
+}
+/**
+ * Raised when creating a repository that already exists and `exist_ok` is false.
+ */
+export class RepositoryExistsError extends ModaicError {
+    constructor(message) {
+        super(message);
+        this.name = "RepositoryExistsError";
+    }
+}
+/* -------------------------------------------------------------------------- */
+/*  Config                                                                     */
+/* -------------------------------------------------------------------------- */
+function stripTrailingSlash(url) {
+    return url.replace(/\/+$/, "");
+}
+/**
+ * Base URL of the Modaic REST API. Mirrors the Python SDK default.
+ */
+export function getApiUrl() {
+    return stripTrailingSlash(process.env["MODAIC_API_URL"] || "https://api.modaic.dev");
+}
+/**
+ * Base URL of the Modaic git host. Mirrors the Python SDK default.
+ */
+export function getGitUrl() {
+    return stripTrailingSlash(process.env["MODAIC_GIT_URL"] || "https://git.modaic.dev");
+}
+/**
+ * Resolve the access token: explicit arg first, then the MODAIC_TOKEN env var.
+ * Throws if neither is set.
+ */
+export function resolveToken(accessToken) {
+    const token = accessToken ?? process.env["MODAIC_TOKEN"];
+    if (!token) {
+        throw new AuthenticationError("No access token provided. Pass access_token or set the MODAIC_TOKEN environment variable.");
+    }
+    return token;
+}
+/**
+ * Root cache directory used for staging git clones. Defaults to
+ * `~/.cache/modaic-ts`; override with the `MODAIC_CACHE` environment variable.
+ */
+export function getCacheDir() {
+    return (process.env["MODAIC_CACHE"] || path.join(os.homedir(), ".cache", "modaic-ts"));
+}
+/**
+ * Local staging directory for a repo's git working tree, keyed by "owner/name".
+ */
+export function stagingDir(repo) {
+    return path.join(getCacheDir(), "staging", ...repo.split("/"));
+}
+//# sourceMappingURL=runtime.js.map

package/esm/modaic/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/modaic/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe,EAAE;QAC3B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAAA,CAC3B;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,OAAe,EAAE;QAC3B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IAAA,CACnC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,WAAW;IACtD,YAAY,OAAe,EAAE;QAC3B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IAAA,CACvC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACpD,YAAY,OAAe,EAAE;QAC3B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IAAA,CACrC;CACF;AAED,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAEhF,SAAS,kBAAkB,CAAC,GAAW,EAAU;IAC/C,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAAA,CAChC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,GAAW;IAClC,OAAO,kBAAkB,CACvB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,wBAAwB,CAC1D,CAAC;AAAA,CACH;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,GAAW;IAClC,OAAO,kBAAkB,CACvB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,wBAAwB,CAC1D,CAAC;AAAA,CACH;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,WAA2B,EAAU;IAChE,MAAM,KAAK,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,mBAAmB,CAC3B,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AAAA,CACd;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,GAAW;IACpC,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,WAAW,CAAC,CAC9E,CAAC;AAAA,CACH;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAU;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAAA,CAChE"}

package/esm/modaic/serialization.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Serialization of modaic Signatures into the canonical artifacts shared with the
+ * Python SDK and Modaic Hub:
+ *
+ *   - `config.json`  — the serialized signature schema (pydantic `model_json_schema`
+ *                      dialect), via {@link serializeSignatureToConfig}.
+ *   - `program.json` — the stored program state (dspy `Module.save` shape), via
+ *                      {@link buildProgramJson}.
+ *
+ * The zod -> JSON Schema walker reproduces only the slice of JSON Schema the Python
+ * deserializer understands, plus the dspy field extras (`__dspy_field_type`, `desc`,
+ * `prefix`, `title`). Special modaic types (Image/Audio/Scale) are detected via a
+ * `.meta().__modaic_type` marker — see `signatures.ts`.
+ */
+import type { Signature } from "./signatures.js";
+export type JsonSchema = Record<string, any>;
+/** Pretty title from a field name: `name.replace("_"," ")` then Python `str.title()`. */
+export declare function pydanticTitle(name: string): string;
+/** Field description: `.describe()`/`.meta({desc})`, falling back to dspy's `${name}`. */
+export declare function fieldDesc(meta: Record<string, any>, name: string): string;
+export interface FieldInfo {
+    fragment: JsonSchema;
+    /** True when the fragment is a bare `$ref` (pydantic omits a field-level `title`). */
+    isRef: boolean;
+    optional: boolean;
+    hasDefault: boolean;
+    defaultValue?: any;
+    meta: Record<string, any>;
+}
+/** Serialize a single Zod field schema into its JSON-Schema fragment + metadata. */
+export declare function serializeField(schema: any, defs: Record<string, JsonSchema>): FieldInfo;
+/**
+ * Recursively sort object keys alphabetically to match pydantic's output, with two
+ * exceptions: the children of `properties` keep declaration order (inputs then
+ * outputs), and `default` payloads are left untouched.
+ */
+export declare function sortSchema(node: any): any;
+/**
+ * Derive a PascalCase signature title from a repo path.
+ *
+ * The Python SDK uses the signature class name as the schema `title`; TS
+ * signatures are anonymous, so we derive a stable title from the repo's name
+ * segment.
+ *
+ * Examples:
+ *   "modaic/quality-judge" -> "QualityJudge"
+ *   "modaic/tyrin_judge"   -> "TyrinJudge"
+ *   "my-judge"             -> "MyJudge"
+ */
+export declare function repoNameToTitle(repo: string): string;
+/**
+ * One field entry inside a serialized signature's `properties`.
+ *
+ * Always carries the dspy extras (`__dspy_field_type`, `desc`, `prefix`) and, for
+ * non-`$ref` fields, a pydantic `title`. The remaining keys are whatever JSON-Schema
+ * type fragment the field's Zod type produced (`type`, `items`, `enum`, `anyOf`,
+ * `$ref`, `additionalProperties`, `prefixItems`, …). Key order in the emitted JSON is
+ * alphabetical, matching the Python (pydantic) output.
+ */
+export interface ConfigField {
+    __dspy_field_type: "input" | "output";
+    desc?: string;
+    prefix?: string | undefined;
+    title?: string;
+    type?: string;
+    default?: unknown;
+    $ref?: string;
+    items?: JsonSchema;
+    enum?: unknown[];
+    const?: unknown;
+    anyOf?: JsonSchema[];
+    additionalProperties?: JsonSchema | boolean;
+    prefixItems?: JsonSchema[];
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * The shape of `config.json` — the serialized signature schema.
+ *
+ * The `signature` object must be compatible with what the Python SDK produces via
+ * `serializers.py::serialize_signature` (and reads back via `_deserialize_dspy_signatures`).
+ * Concretely:
+ *
+ * ```json
+ * {
+ *   "model": null,
+ *   "signature": {
+ *     "$defs": { "Image": { "type": "dspy.Image" } },   // only when special types are used
+ *     "description": "<instructions>",
+ *     "properties": {
+ *       "<field>": { "__dspy_field_type": "input"|"output", "desc": "...",
+ *                    "prefix": "Field:", "title": "Field", "type": "string" }
+ *     },
+ *     "required": ["<input fields then output fields>"],
+ *     "title": "<PascalCase repo name>",
+ *     "type": "object"
+ *   }
+ * }
+ * ```
+ */
+export interface ConfigJson {
+    model: null;
+    signature: {
+        $defs?: Record<string, JsonSchema>;
+        description: string;
+        properties: Record<string, ConfigField>;
+        required: string[];
+        title: string;
+        type: "object";
+    };
+}
+/**
+ * Build `config.json` from a Signature.
+ *
+ * Input fields are emitted before output fields (matching dspy). A field is in
+ * `required` unless it has a Zod default or is `.optional()`. Special modaic types
+ * (Image/Audio/Scale/Enum — see `signatures.ts`) serialize to the same JSON the
+ * Python SDK uses, so the result round-trips into a `dspy.Signature` with no Python
+ * changes.
+ *
+ * @param signature The Arbiter's signature.
+ * @param title The top-level schema title (derived from the repo name).
+ */
+export declare function serializeSignatureToConfig(signature: Signature, title: string): ConfigJson;
+/**
+ * The serialized `lm` block inside `program.json`. Mirrors what dspy's
+ * `LM.dump_state()` writes (see `dspy/clients/lm.py`): the inference model plus
+ * its default knobs. The Modaic server reconstructs an LM via `LM(**lm)`, so
+ * `model` is the only field it strictly needs; the rest pin dspy's defaults so
+ * the stored state round-trips exactly. No secrets are ever included — an
+ * `api_key`, if any, is filled in server-side at load time.
+ */
+export interface LMState {
+    /** A LiteLLM model string, e.g. "gpt-oss-120b" or "openai/gpt-4o". */
+    model: string;
+    model_type: string;
+    cache: boolean;
+    num_retries: number;
+    finetuning_model: string | null;
+    launch_kwargs: Record<string, unknown>;
+    train_kwargs: Record<string, unknown>;
+    temperature: number | null;
+    max_tokens: number | null;
+}
+/**
+ * Build the `lm` state for a model string, matching `dspy.LM(model).dump_state()`
+ * with dspy's constructor defaults (model_type="chat", cache=true, num_retries=3,
+ * finetuning_model=None, launch_kwargs={}, train_kwargs={}, temperature=None,
+ * max_tokens=None). Key order matches the Python artifact.
+ */
+export declare function lmStateFromModel(model: string): LMState;
+/**
+ * The shape of `program.json` — the stored program state.
+ *
+ * Mirrors what the Python SDK writes via `dspy.Module.save` (`precompiled.py`):
+ *
+ * ```json
+ * {
+ *   "traces": [], "train": [], "demos": [],
+ *   "signature": { "instructions": "...", "fields": [ { "prefix": "Text:", "description": "..." } ] },
+ *   "lm": null,
+ *   "metadata": { "dependency_versions": { ... } }
+ * }
+ * ```
+ *
+ * The `signature` field is exactly what `Signature.dump_state()` returns.
+ */
+export interface ProgramJson {
+    traces: unknown[];
+    train: unknown[];
+    demos: unknown[];
+    signature: {
+        instructions?: string;
+        fields: {
+            prefix: string;
+            description: string;
+        }[];
+    };
+    lm: LMState | null;
+    metadata: {
+        dependency_versions: Record<string, string>;
+    };
+}
+/**
+ * Build the `program.json` object for a Signature and inference model.
+ *
+ * Mirrors dspy's `Module.save`: emit the flat dspy-`Predict` state
+ * (`traces`/`train`/`demos`/`signature`/`lm`) then append `metadata`. `model` is a
+ * LiteLLM model string written into the `lm` block (without secrets — the Python
+ * SDK's `_clean_secrets` masks secret *values* inside `lm` but keeps the model, so a
+ * null `lm` would leave the judge unrunnable on the server). Key order: traces,
+ * train, demos, signature, lm, metadata.
+ */
+export declare function buildProgramJson(signature: Signature, model: string): ProgramJson;
+//# sourceMappingURL=serialization.d.ts.map

package/esm/modaic/serialization.d.ts.map

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