modaic 0.1.0

package/esm/modaic/api.js

@@ -0,0 +1,131 @@
+import { getApiUrl, getGitUrl } from "./runtime.js";
+import { AuthenticationError, ModaicError, RepositoryExistsError, } from "./runtime.js";
+/** Headers for the git host / repo-management endpoints (`Authorization: token <tok>`). */
+function gitHeaders(token) {
+    return {
+        Authorization: `token ${token}`,
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        "User-Agent": "ModaicTS/0.1",
+    };
+}
+/** Headers for the Modaic REST API (`Authorization: Bearer <tok>`). */
+function bearerHeaders(token) {
+    return {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json",
+    };
+}
+async function errorBody(res) {
+    try {
+        // FastAPI surfaces errors under `detail`; some endpoints use `message`.
+        // Read both so server errors aren't collapsed to a bare "HTTP 500".
+        const data = (await res.json());
+        const detail = typeof data.detail === "string"
+            ? data.detail
+            : data.detail != null
+                ? JSON.stringify(data.detail)
+                : undefined;
+        return detail ?? data.message ?? `HTTP ${res.status}`;
+    }
+    catch {
+        return `HTTP ${res.status}`;
+    }
+}
+/**
+ * Fetch the user info for an access token. Used to build the authenticated git
+ * remote URL and to set the commit identity.
+ */
+export async function getUserInfo(token) {
+    const url = `${getGitUrl()}/api/v1/user`;
+    const res = await fetch(url, { headers: gitHeaders(token) });
+    if (res.status === 401) {
+        throw new AuthenticationError("Invalid access token or authentication failed");
+    }
+    if (!res.ok) {
+        throw new ModaicError(`Failed to fetch user info: ${await errorBody(res)}`);
+    }
+    const data = (await res.json());
+    return { login: data.login, email: data.email, name: data.full_name };
+}
+/**
+ * Create a repo on the hub. Returns true if created, false if it already existed
+ * (when `existOk`). Mirrors `ModaicClient.create_repo`.
+ */
+export async function createRepo(repo, opts) {
+    const [username, name] = repo.split("/", 2);
+    if (!username || !name) {
+        throw new ModaicError(`Invalid repo path '${repo}'. Expected 'owner/name'.`);
+    }
+    const payload = {
+        username,
+        name,
+        description: "",
+        private: opts.private,
+        auto_init: true,
+        default_branch: "main",
+        trust_model: "default",
+    };
+    const res = await fetch(`${getApiUrl()}/api/v2/repos`, {
+        method: "POST",
+        headers: gitHeaders(opts.token),
+        body: JSON.stringify(payload),
+    });
+    if (res.ok)
+        return true;
+    const message = await errorBody(res);
+    if (res.status === 409 || res.status === 422 || message.toLowerCase().includes("already exists")) {
+        if (opts.existOk)
+            return false;
+        throw new RepositoryExistsError(`Repository '${repo}' already exists`);
+    }
+    if (res.status === 401) {
+        throw new AuthenticationError("Invalid access token or authentication failed");
+    }
+    if (res.status === 403) {
+        throw new AuthenticationError("Access denied - insufficient permissions");
+    }
+    throw new ModaicError(`Failed to create repository: ${message}`);
+}
+/**
+ * Run a deployed Arbiter against a single input via the Modaic API.
+ * The server runs the LLM; this is a pure HTTP call. Mirrors
+ * `POST /api/v2/arbiters/predictions`.
+ */
+export async function predict(args) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 300000);
+    try {
+        const res = await fetch(`${getApiUrl()}/api/v2/arbiters/predictions`, {
+            method: "POST",
+            headers: bearerHeaders(args.token),
+            body: JSON.stringify({
+                input: args.input,
+                arbiter_repo: args.arbiterRepo,
+                arbiter_revision: args.arbiterRevision,
+                ground_truth: args.groundTruth ?? null,
+                ground_reasoning: args.groundReasoning ?? "",
+                compute_confidence: args.computeConfidence ?? false,
+            }),
+            signal: controller.signal,
+        });
+        if (res.status === 401) {
+            throw new AuthenticationError("Invalid access token or authentication failed");
+        }
+        if (!res.ok) {
+            throw new ModaicError(`Prediction failed: ${await errorBody(res)}`);
+        }
+        const data = (await res.json());
+        return {
+            exampleId: data.example_id,
+            predictionId: data.prediction_id,
+            output: data.output,
+            reasoning: data.reasoning,
+            messages: data.messages ?? [],
+        };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+//# sourceMappingURL=api.js.map

package/esm/modaic/api.js.map

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

package/esm/modaic/arbiter.d.ts

@@ -0,0 +1,101 @@
+import { z } from "zod";
+import { Signature } from "./signatures.js";
+import { type Commit } from "./git.js";
+import type { PredictExampleResponse } from "../models/index.js";
+/**
+ * Return a Signature guaranteed to have a `reasoning` output field — the TS analog
+ * of Python `make_arbiter`. Arbiters must expose a plain `reasoning: string` output
+ * because the server reads `prediction.reasoning` on every prediction; without it,
+ * predictions fail server-side.
+ *
+ * Mirrors `make_arbiter`'s `signature.insert(-2, "reasoning", …)`: reasoning is
+ * inserted within the output section just before the last output field (so a
+ * single-output judge gets reasoning first). Idempotent — if a `reasoning` output
+ * already exists, the signature is returned unchanged.
+ */
+export declare function ensure_reasoning_field(signature: Signature): Signature<z.ZodObject<any>, z.ZodObject<any>>;
+/** Options for constructing an Arbiter handle to an existing repo. */
+export interface ArbiterOptions {
+    /** Git branch used for create/update operations. Default "main". */
+    branch?: string;
+    /** Revision (branch/tag/commit) used when running predictions. Default = branch. */
+    rev?: string;
+}
+/** Options for `Arbiter.create`. */
+export interface CreateOptions {
+    repo: string;
+    signature: Signature;
+    /**
+     * The LiteLLM model string the server runs this judge with, e.g.
+     * "gpt-oss-120b" or "openai/gpt-4o". Required — an arbiter with no model is
+     * not runnable: `predict()` would fail server-side.
+     */
+    model: string;
+    branch?: string;
+    tag?: string;
+    access_token?: string;
+    commit_message?: string;
+    private?: boolean;
+    metadata?: Record<string, unknown> | null;
+    extra_files?: string[] | null;
+}
+/** Options for `arbiter.update`. */
+export interface UpdateOptions {
+    /** Optional new signature; when provided, config.json and program.json are rewritten. */
+    signature?: Signature;
+    /**
+     * LiteLLM model string. Required when `signature` is provided, since rewriting
+     * `program.json` needs the model written into its `lm` block.
+     */
+    model?: string;
+    metadata?: Record<string, unknown> | null;
+    extra_files?: string[] | null;
+    commit_message?: string;
+    tag?: string;
+    access_token?: string;
+}
+/** Options for `arbiter.predict`. */
+export interface PredictOptions {
+    ground_truth?: Record<string, unknown> | null;
+    ground_reasoning?: string;
+    compute_confidence?: boolean;
+}
+/**
+ * A handle to a Modaic Arbiter (an LLM judge) stored on Modaic Hub.
+ *
+ * Like `modaic_client.Arbiter`, this is a thin wrapper over the Modaic REST API
+ * and git — it never runs an LLM locally. `predict()` calls the API; `create()`
+ * and `update()` write the judge's `config.json` / `program.json` and push them
+ * to the hub via git, mirroring `modaic.Predict.push_to_hub`.
+ */
+export declare class Arbiter {
+    repo: string;
+    branch: string;
+    rev: string;
+    constructor(repo: string, opts?: ArbiterOptions);
+    /**
+     * Create a new Arbiter repo on the hub and push its signature.
+     *
+     * Builds `config.json` (signature schema) and `program.json` (stored prompt)
+     * the same way the Python SDK does, creates the remote repo (private by
+     * default), then commits & pushes on `branch`.
+     */
+    static create(opts: CreateOptions): Promise<Arbiter>;
+    /**
+     * Pull the latest commit of this Arbiter's branch, write whatever is provided
+     * (a new signature rewrites config.json + program.json; metadata updates the
+     * README; extra_files are copied in), then commit & push.
+     */
+    update(opts?: UpdateOptions): Promise<Commit>;
+    /**
+     * Run this Arbiter against a single input via the Modaic API. The server runs
+     * the LLM; this is a pure HTTP call through the generated SDK
+     * (`POST /api/v2/arbiters/predictions`).
+     */
+    predict(input: Record<string, unknown>, opts?: PredictOptions): Promise<PredictExampleResponse>;
+    /**
+     * Alias for {@link predict}. (Python's `__call__` is not idiomatic in TS.)
+     */
+    call(input: Record<string, unknown>, opts?: PredictOptions): Promise<PredictExampleResponse>;
+}
+//# sourceMappingURL=arbiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arbiter.d.ts","sourceRoot":"","sources":["../../src/modaic/arbiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAO5C,OAAO,EAGL,KAAK,MAAM,EAEZ,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAUjE;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,GACnB,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAkC/C;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,CAAC;IACrB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC/B;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,yFAAyF;IACzF,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,qBAAa,OAAO;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IAEZ,YAAY,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,EAIlD;IAED;;;;;;OAMG;IACH,OAAa,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CA+BzD;IAED;;;;OAIG;IACG,MAAM,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BtD;IAED;;;;OAIG;IACG,OAAO,CACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAajC;IAED;;OAEG;IACH,IAAI,CACF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAEjC;CACF"}

package/esm/modaic/arbiter.js

@@ -0,0 +1,161 @@
+import { z } from "zod";
+import { Signature } from "./signatures.js";
+import { serializeSignatureToConfig, buildProgramJson, repoNameToTitle, } from "./serialization.js";
+import { resolveToken, getApiUrl } from "./runtime.js";
+import { syncAndPush, createRepo, } from "./git.js";
+import { ModaicClient } from "../sdk/sdk.js";
+/**
+ * The fixed description given to an Arbiter's injected `reasoning` output field.
+ * Matches the Python SDK (`make_arbiter`) verbatim — original wording included —
+ * so judges authored here stay byte-compatible with Python ones.
+ */
+const REASONING_DESC = "Your reasoning for your answer. Inlude any uncertainties about your answer or ambiguity in the task.";
+/**
+ * Return a Signature guaranteed to have a `reasoning` output field — the TS analog
+ * of Python `make_arbiter`. Arbiters must expose a plain `reasoning: string` output
+ * because the server reads `prediction.reasoning` on every prediction; without it,
+ * predictions fail server-side.
+ *
+ * Mirrors `make_arbiter`'s `signature.insert(-2, "reasoning", …)`: reasoning is
+ * inserted within the output section just before the last output field (so a
+ * single-output judge gets reasoning first). Idempotent — if a `reasoning` output
+ * already exists, the signature is returned unchanged.
+ */
+export function ensure_reasoning_field(signature) {
+    const outShape = signature.output.shape;
+    if ("reasoning" in outShape) {
+        return new Signature({
+            instructions: signature.instructions,
+            input: signature.input,
+            output: signature.output,
+        });
+    }
+    // A plain string field. Set the description on both `.describe()` and `.meta()`
+    // so it surfaces in program.json (dump_state) and config.json (serializeField).
+    let reasoningField = z.string().describe(REASONING_DESC);
+    if (typeof reasoningField.meta === "function") {
+        reasoningField = reasoningField.meta({
+            description: REASONING_DESC,
+            desc: REASONING_DESC,
+        });
+    }
+    const entries = Object.entries(outShape);
+    const insertIdx = Math.max(0, entries.length - 1);
+    const newShape = {};
+    entries.forEach(([k, field], i) => {
+        if (i === insertIdx)
+            newShape["reasoning"] = reasoningField;
+        newShape[k] = field;
+    });
+    if (entries.length === 0)
+        newShape["reasoning"] = reasoningField;
+    return new Signature({
+        instructions: signature.instructions,
+        input: signature.input,
+        output: z.object(newShape),
+    });
+}
+/**
+ * A handle to a Modaic Arbiter (an LLM judge) stored on Modaic Hub.
+ *
+ * Like `modaic_client.Arbiter`, this is a thin wrapper over the Modaic REST API
+ * and git — it never runs an LLM locally. `predict()` calls the API; `create()`
+ * and `update()` write the judge's `config.json` / `program.json` and push them
+ * to the hub via git, mirroring `modaic.Predict.push_to_hub`.
+ */
+export class Arbiter {
+    repo;
+    branch;
+    rev;
+    constructor(repo, opts = {}) {
+        this.repo = repo;
+        this.branch = opts.branch ?? "main";
+        this.rev = opts.rev ?? this.branch;
+    }
+    /**
+     * Create a new Arbiter repo on the hub and push its signature.
+     *
+     * Builds `config.json` (signature schema) and `program.json` (stored prompt)
+     * the same way the Python SDK does, creates the remote repo (private by
+     * default), then commits & pushes on `branch`.
+     */
+    static async create(opts) {
+        const branch = opts.branch ?? "main";
+        const token = resolveToken(opts.access_token);
+        // Build files first so a bad signature fails before we create a repo.
+        // Inject the `reasoning` output field so the judge is a valid Arbiter.
+        const signature = ensure_reasoning_field(opts.signature);
+        const config = serializeSignatureToConfig(signature, repoNameToTitle(opts.repo));
+        const program = buildProgramJson(signature, opts.model);
+        await createRepo(opts.repo, {
+            private: opts.private ?? true,
+            existOk: true,
+            token,
+        });
+        await syncAndPush({
+            repo: opts.repo,
+            branch,
+            token,
+            files: { config, program },
+            metadata: opts.metadata ?? null,
+            extraFiles: opts.extra_files ?? null,
+            commitMessage: opts.commit_message ?? "(no commit message)",
+            tag: opts.tag,
+        });
+        return new Arbiter(opts.repo, { branch, rev: opts.tag ?? branch });
+    }
+    /**
+     * Pull the latest commit of this Arbiter's branch, write whatever is provided
+     * (a new signature rewrites config.json + program.json; metadata updates the
+     * README; extra_files are copied in), then commit & push.
+     */
+    async update(opts = {}) {
+        const token = resolveToken(opts.access_token);
+        const files = {};
+        if (opts.signature) {
+            if (!opts.model) {
+                throw new Error("update() requires `model` when `signature` is provided, so the " +
+                    "rewritten program.json records the inference model.");
+            }
+            const signature = ensure_reasoning_field(opts.signature);
+            files.config = serializeSignatureToConfig(signature, repoNameToTitle(this.repo));
+            files.program = buildProgramJson(signature, opts.model);
+        }
+        return syncAndPush({
+            repo: this.repo,
+            branch: this.branch,
+            token,
+            files,
+            metadata: opts.metadata ?? null,
+            extraFiles: opts.extra_files ?? null,
+            commitMessage: opts.commit_message ?? "(no commit message)",
+            tag: opts.tag,
+        });
+    }
+    /**
+     * Run this Arbiter against a single input via the Modaic API. The server runs
+     * the LLM; this is a pure HTTP call through the generated SDK
+     * (`POST /api/v2/arbiters/predictions`).
+     */
+    async predict(input, opts = {}) {
+        // Resolve the token up front so a missing token throws AuthenticationError
+        // before any client is constructed.
+        const token = resolveToken();
+        const client = new ModaicClient({ token, serverURL: getApiUrl() });
+        return client.createPredictionApiV2ArbitersPredictionsPost({
+            input,
+            arbiterRepo: this.repo,
+            arbiterRevision: this.rev,
+            groundTruth: opts.ground_truth ?? null,
+            groundReasoning: opts.ground_reasoning ?? "",
+            computeConfidence: opts.compute_confidence ?? false,
+        });
+    }
+    /**
+     * Alias for {@link predict}. (Python's `__call__` is not idiomatic in TS.)
+     */
+    call(input, opts = {}) {
+        return this.predict(input, opts);
+    }
+}
+//# sourceMappingURL=arbiter.js.map

package/esm/modaic/arbiter.js.map

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

package/esm/modaic/git.d.ts

@@ -0,0 +1,59 @@
+/** User identity returned by the git host's `/api/v1/user` endpoint. */
+export interface UserInfo {
+    login: string;
+    email: string;
+    name: string;
+}
+/**
+ * Fetch the user info for an access token. Used to build the authenticated git
+ * remote URL and to set the commit identity. Hits the git host (`git.modaic.dev`),
+ * which is a separate service from the Modaic REST API.
+ */
+export declare function getUserInfo(token: string): Promise<UserInfo>;
+/**
+ * Create a repo on the hub. Returns true if created, false if it already existed
+ * (when `existOk`). Mirrors `ModaicClient.create_repo`. Not part of the documented
+ * SDK surface, so it stays a hand-written call.
+ */
+export declare function createRepo(repo: string, opts: {
+    private: boolean;
+    existOk: boolean;
+    token: string;
+}): Promise<boolean>;
+/** Files to (re)write into the repo before committing. */
+export interface PushFiles {
+    /** Parsed `config.json` content. Omit to leave the existing file untouched. */
+    config?: object;
+    /** Parsed `program.json` content. Omit to leave the existing file untouched. */
+    program?: object;
+}
+export interface SyncAndPushOptions {
+    /** "owner/name". */
+    repo: string;
+    /** Branch to commit and push to. */
+    branch: string;
+    /** Resolved access token. */
+    token: string;
+    /** Files to write. */
+    files: PushFiles;
+    /** Optional metadata written to README.md YAML frontmatter. */
+    metadata?: Record<string, unknown> | null;
+    /** Optional local file paths copied to the repo root. */
+    extraFiles?: string[] | null;
+    /** Commit message. */
+    commitMessage: string;
+    /** Optional tag to create and push. */
+    tag?: string | undefined;
+}
+/** The commit produced by a push. */
+export interface Commit {
+    repo: string;
+    sha: string;
+}
+/**
+ * Simpler version of the Python SDK's `sync_and_push`: pull the latest commit of
+ * the target branch, write the program/config/metadata/extra files, commit, and
+ * push using a token-authenticated remote. Assumes the remote repo already exists.
+ */
+export declare function syncAndPush(opts: SyncAndPushOptions): Promise<Commit>;
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/modaic/git.ts"],"names":[],"mappings":"AAsBA,wEAAwE;AACxE,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AA6BD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAelE;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1D,OAAO,CAAC,OAAO,CAAC,CAiClB;AAMD,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC7B,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,qCAAqC;AACrC,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAwCD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiE3E"}

package/esm/modaic/git.js

@@ -0,0 +1,193 @@
+import fs from "node:fs";
+import path from "node:path";
+import matter from "gray-matter";
+import { simpleGit } from "simple-git";
+import { getApiUrl, getGitUrl, stagingDir, ModaicError, AuthenticationError, RepositoryExistsError, } from "./runtime.js";
+/** Headers for the git host / repo-management endpoints (`Authorization: token <tok>`). */
+function gitHeaders(token) {
+    return {
+        Authorization: `token ${token}`,
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        "User-Agent": "ModaicTS/0.1",
+    };
+}
+async function errorBody(res) {
+    try {
+        // FastAPI surfaces errors under `detail`; some endpoints use `message`.
+        // Read both so server errors aren't collapsed to a bare "HTTP 500".
+        const data = (await res.json());
+        const detail = typeof data.detail === "string"
+            ? data.detail
+            : data.detail != null
+                ? JSON.stringify(data.detail)
+                : undefined;
+        return detail ?? data.message ?? `HTTP ${res.status}`;
+    }
+    catch {
+        return `HTTP ${res.status}`;
+    }
+}
+/**
+ * Fetch the user info for an access token. Used to build the authenticated git
+ * remote URL and to set the commit identity. Hits the git host (`git.modaic.dev`),
+ * which is a separate service from the Modaic REST API.
+ */
+export async function getUserInfo(token) {
+    const url = `${getGitUrl()}/api/v1/user`;
+    const res = await fetch(url, { headers: gitHeaders(token) });
+    if (res.status === 401) {
+        throw new AuthenticationError("Invalid access token or authentication failed");
+    }
+    if (!res.ok) {
+        throw new ModaicError(`Failed to fetch user info: ${await errorBody(res)}`);
+    }
+    const data = (await res.json());
+    return { login: data.login, email: data.email, name: data.full_name };
+}
+/**
+ * Create a repo on the hub. Returns true if created, false if it already existed
+ * (when `existOk`). Mirrors `ModaicClient.create_repo`. Not part of the documented
+ * SDK surface, so it stays a hand-written call.
+ */
+export async function createRepo(repo, opts) {
+    const [username, name] = repo.split("/", 2);
+    if (!username || !name) {
+        throw new ModaicError(`Invalid repo path '${repo}'. Expected 'owner/name'.`);
+    }
+    const payload = {
+        username,
+        name,
+        description: "",
+        private: opts.private,
+        auto_init: true,
+        default_branch: "main",
+        trust_model: "default",
+    };
+    const res = await fetch(`${getApiUrl()}/api/v2/repos`, {
+        method: "POST",
+        headers: gitHeaders(opts.token),
+        body: JSON.stringify(payload),
+    });
+    if (res.ok)
+        return true;
+    const message = await errorBody(res);
+    if (res.status === 409 || res.status === 422 || message.toLowerCase().includes("already exists")) {
+        if (opts.existOk)
+            return false;
+        throw new RepositoryExistsError(`Repository '${repo}' already exists`);
+    }
+    if (res.status === 401) {
+        throw new AuthenticationError("Invalid access token or authentication failed");
+    }
+    if (res.status === 403) {
+        throw new AuthenticationError("Access denied - insufficient permissions");
+    }
+    throw new ModaicError(`Failed to create repository: ${message}`);
+}
+function makeGitUrl(repo, token, login) {
+    const gitUrl = getGitUrl();
+    const protocol = gitUrl.startsWith("https://") ? "https://" : "http://";
+    const host = gitUrl.replace(/^https?:\/\//, "");
+    return `${protocol}${login}:${token}@${host}/${repo}.git`;
+}
+function writeJson(filePath, obj) {
+    // Match Python's json.dump(..., indent=2): 2-space indent, no trailing newline.
+    fs.writeFileSync(filePath, JSON.stringify(obj, null, 2));
+}
+/** Create or replace the README's YAML frontmatter, preserving the body. */
+function writeReadmeFrontmatter(filePath, metadata) {
+    let body = "";
+    if (fs.existsSync(filePath)) {
+        body = matter(fs.readFileSync(filePath, "utf-8")).content;
+    }
+    fs.writeFileSync(filePath, matter.stringify(body, metadata));
+}
+/** Check out `branch`, tracking origin/branch, falling back to origin/main, then a fresh branch. */
+async function checkoutBranch(git, branch) {
+    try {
+        await git.checkout(["-B", branch, `origin/${branch}`]);
+        return;
+    }
+    catch {
+        /* branch does not exist on origin yet */
+    }
+    try {
+        await git.checkout(["-B", branch, "origin/main"]);
+        return;
+    }
+    catch {
+        /* main does not exist either (brand new repo with no commits) */
+    }
+    await git.checkout(["-B", branch]);
+}
+/**
+ * Simpler version of the Python SDK's `sync_and_push`: pull the latest commit of
+ * the target branch, write the program/config/metadata/extra files, commit, and
+ * push using a token-authenticated remote. Assumes the remote repo already exists.
+ */
+export async function syncAndPush(opts) {
+    const dir = stagingDir(opts.repo);
+    fs.mkdirSync(dir, { recursive: true });
+    const git = simpleGit(dir);
+    if (!fs.existsSync(path.join(dir, ".git"))) {
+        await git.init();
+    }
+    const user = await getUserInfo(opts.token);
+    const remoteUrl = makeGitUrl(opts.repo, opts.token, user.login);
+    const remotes = await git.getRemotes();
+    if (remotes.some((r) => r.name === "origin")) {
+        await git.remote(["set-url", "origin", remoteUrl]);
+    }
+    else {
+        await git.addRemote("origin", remoteUrl);
+    }
+    try {
+        await git.fetch("origin");
+    }
+    catch (e) {
+        const msg = String(e).toLowerCase();
+        if (msg.includes("not found") || msg.includes("repository")) {
+            throw new ModaicError(`Repository '${opts.repo}' does not exist`);
+        }
+        throw new ModaicError(`Git fetch failed: ${e}`);
+    }
+    await checkoutBranch(git, opts.branch);
+    // Write the desired repo contents.
+    if (opts.files.config)
+        writeJson(path.join(dir, "config.json"), opts.files.config);
+    if (opts.files.program)
+        writeJson(path.join(dir, "program.json"), opts.files.program);
+    if (opts.metadata)
+        writeReadmeFrontmatter(path.join(dir, "README.md"), opts.metadata);
+    if (opts.extraFiles) {
+        for (const file of opts.extraFiles) {
+            fs.copyFileSync(file, path.join(dir, path.basename(file)));
+        }
+    }
+    await git.add(["-A"]);
+    await git.addConfig("user.email", user.email);
+    await git.addConfig("user.name", user.name);
+    try {
+        await git.commit(opts.commitMessage);
+    }
+    catch (e) {
+        if (String(e).toLowerCase().includes("nothing to commit")) {
+            throw new ModaicError("Nothing to commit");
+        }
+        throw new ModaicError(`Git commit failed: ${e}`);
+    }
+    try {
+        await git.push("origin", opts.branch);
+        if (opts.tag) {
+            await git.addTag(opts.tag);
+            await git.raw(["push", "origin", opts.tag]);
+        }
+    }
+    catch (e) {
+        throw new ModaicError(`Git push failed: ${e}`);
+    }
+    const sha = (await git.revparse(["HEAD"])).trim();
+    return { repo: opts.repo, sha };
+}
+//# sourceMappingURL=git.js.map