@runapi.ai/mcp 0.1.0

package/dist/src/lib/runapi-client.js

@@ -0,0 +1,119 @@
+import { USER_AGENT } from "../constants.js";
+import { loadConfig, requireApiKey } from "../config.js";
+import { errorFromResponse, PollTimeoutError } from "./errors.js";
+const COMPLETED_STATUSES = new Set(["completed", "complete", "succeeded", "success", "finished"]);
+const FAILED_STATUSES = new Set(["failed", "error", "canceled", "cancelled", "timeout"]);
+export class RunApiClient {
+    config;
+    fetchImpl;
+    constructor(config = loadConfig(), fetchImpl = fetch) {
+        this.config = config;
+        this.fetchImpl = fetchImpl;
+    }
+    async listModels() {
+        return this.request("GET", "/v1/models", { auth: false });
+    }
+    async balance() {
+        return this.request("GET", "/api/v1/me/balance", { auth: true });
+    }
+    async createTask(service, action, params) {
+        return this.request("POST", `/api/v1/${routeServiceSlug(service)}/${action}`, {
+            auth: true,
+            body: params
+        });
+    }
+    async getTask(service, taskId, action) {
+        const routeService = routeServiceSlug(service);
+        const path = action ? `/api/v1/${routeService}/${action}/${taskId}` : `/api/v1/${routeService}/${taskId}`;
+        return this.request("GET", path, {
+            auth: true
+        });
+    }
+    async pollTask(service, taskId, action, options = {}) {
+        const timeoutMs = options.timeoutMs ?? 120_000;
+        const intervalMs = options.intervalMs ?? 5_000;
+        const startedAt = Date.now();
+        let lastTask;
+        while (Date.now() - startedAt < timeoutMs) {
+            const task = await this.getTask(service, taskId, action);
+            lastTask = task;
+            await options.onProgress?.(task);
+            const status = taskStatus(task);
+            if (COMPLETED_STATUSES.has(status) || FAILED_STATUSES.has(status)) {
+                return task;
+            }
+            await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        }
+        throw new PollTimeoutError(`Timed out waiting for RunAPI task ${taskId}. Last status: ${taskStatus(lastTask)}.`);
+    }
+    async chat(params) {
+        if (params.api === "chat_completions") {
+            return this.request("POST", "/v1/chat/completions", {
+                auth: true,
+                body: {
+                    model: params.model,
+                    messages: params.messages,
+                    max_tokens: params.max_tokens,
+                    temperature: params.temperature
+                }
+            });
+        }
+        const system = params.messages.find((message) => message.role === "system")?.content;
+        const messages = params.messages.filter((message) => message.role !== "system");
+        return this.request("POST", "/v1/messages", {
+            auth: true,
+            body: {
+                model: params.model,
+                system,
+                messages,
+                max_tokens: params.max_tokens ?? 1024,
+                temperature: params.temperature
+            }
+        });
+    }
+    async request(method, requestPath, options = {}) {
+        const url = new URL(requestPath, this.config.baseUrl.replace(/\/+$/, ""));
+        const headers = {
+            accept: "application/json",
+            "user-agent": USER_AGENT,
+            ...options.headers
+        };
+        if (options.body !== undefined) {
+            headers["content-type"] = "application/json";
+        }
+        if (options.auth !== false) {
+            headers.authorization = `Bearer ${requireApiKey(this.config)}`;
+        }
+        const response = await this.fetchImpl(url, {
+            method,
+            headers,
+            body: options.body === undefined ? undefined : JSON.stringify(options.body)
+        });
+        if (!response.ok) {
+            throw await errorFromResponse(response);
+        }
+        if (response.status === 204) {
+            return undefined;
+        }
+        return await response.json();
+    }
+}
+export function taskStatus(task) {
+    const status = task?.status || task?.state || nestedString(task?.data, "status");
+    return typeof status === "string" ? status.toLowerCase() : "unknown";
+}
+export function taskIdFromResponse(task) {
+    const id = task.id || task.task_id || nestedString(task.data, "id") || nestedString(task.data, "task_id");
+    return typeof id === "string" && id.length > 0 ? id : undefined;
+}
+function nestedString(value, key) {
+    if (!value || typeof value !== "object") {
+        return undefined;
+    }
+    const nested = value[key];
+    return typeof nested === "string" ? nested : undefined;
+}
+function routeServiceSlug(service) {
+    return service.replace(/-/g, "_");
+}
+//# sourceMappingURL=runapi-client.js.map

package/dist/src/lib/runapi-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runapi-client.js","sourceRoot":"","sources":["../../../src/lib/runapi-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAqB,MAAM,cAAc,CAAC;AAE5E,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQlE,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAClG,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;AAEzF,MAAM,OAAO,YAAY;IAEJ;IACA;IAFnB,YACmB,SAAuB,UAAU,EAAE,EACnC,YAA0B,KAAK;QAD/B,WAAM,GAAN,MAAM,CAA6B;QACnC,cAAS,GAAT,SAAS,CAAsB;IAC/C,CAAC;IAEJ,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe,EAAE,MAAc,EAAE,MAA+B;QAC/E,OAAO,IAAI,CAAC,OAAO,CAAqB,MAAM,EAAE,WAAW,gBAAgB,CAAC,OAAO,CAAC,IAAI,MAAM,EAAE,EAAE;YAChG,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,MAAc,EAAE,MAAe;QAC5D,MAAM,YAAY,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,YAAY,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,WAAW,YAAY,IAAI,MAAM,EAAE,CAAC;QAC1G,OAAO,IAAI,CAAC,OAAO,CAAqB,KAAK,EAAE,IAAI,EAAE;YACnD,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,MAAc,EAAE,MAAe,EAAE,UAA0B,EAAE;QAC3F,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC;QAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,QAAwC,CAAC;QAE7C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YACzD,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;YAEjC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClE,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,IAAI,gBAAgB,CAAC,qCAAqC,MAAM,kBAAkB,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACnH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAMV;QACC,IAAI,MAAM,CAAC,GAAG,KAAK,kBAAkB,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,sBAAsB,EAAE;gBAClD,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE;oBACJ,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;iBAChC;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,OAAO,CAAC;QACrF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAEhF,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE;YAC1C,IAAI,EAAE,IAAI;YACV,IAAI,EAAE;gBACJ,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM;gBACN,QAAQ;gBACR,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;gBACrC,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC;SACF,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,OAAO,CAAc,MAAc,EAAE,WAAmB,EAAE,UAA0B,EAAE;QAClG,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1E,MAAM,OAAO,GAA2B;YACtC,MAAM,EAAE,kBAAkB;YAC1B,YAAY,EAAE,UAAU;YACxB,GAAG,OAAO,CAAC,OAAO;SACnB,CAAC;QAEF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAC/C,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,aAAa,GAAG,UAAU,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;YACzC,MAAM;YACN,OAAO;YACP,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;SAC5E,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO,SAAc,CAAC;QACxB,CAAC;QAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAO,CAAC;IACpC,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAC,IAAyB;IAClD,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,IAAI,EAAE,KAAK,IAAI,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACjF,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAwB;IACzD,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC1G,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC;AAED,SAAS,YAAY,CAAC,KAAc,EAAE,GAAW;IAC/C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;IACvD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACpC,CAAC"}

package/dist/src/lib/schema.d.ts

@@ -0,0 +1,3 @@
+import { z } from "zod";
+import type { ContractField } from "../types.js";
+export declare function validateParams(fields: Record<string, ContractField>, params: Record<string, unknown>): z.objectOutputType<Record<string, z.ZodTypeAny>, z.ZodTypeAny, "passthrough">;

package/dist/src/lib/schema.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+export function validateParams(fields, params) {
+    return z.object(schemaShape(fields)).passthrough().parse(params);
+}
+// The contract stores constraints, not complete JSON Schema. This keeps strict
+// checks for required/enums/ranges while allowing API-specific params to pass through.
+function schemaShape(fields) {
+    return Object.fromEntries(Object.entries(fields).map(([name, field]) => [name, zodForField(field)]));
+}
+function zodForField(field) {
+    let schema;
+    if (field.enum?.length) {
+        schema = z.union(field.enum.map((value) => literalFor(value)));
+    }
+    else if (field.type === "number" || field.type === "integer" || field.min !== undefined || field.max !== undefined || field.minimum !== undefined || field.maximum !== undefined) {
+        let numberSchema = z.number();
+        const min = field.min ?? field.minimum;
+        const max = field.max ?? field.maximum;
+        if (min !== undefined) {
+            numberSchema = numberSchema.min(min);
+        }
+        if (max !== undefined) {
+            numberSchema = numberSchema.max(max);
+        }
+        schema = numberSchema;
+    }
+    else if (field.type === "boolean") {
+        schema = z.boolean();
+    }
+    else if (field.type === "array") {
+        schema = z.array(z.unknown());
+    }
+    else if (field.type === "object") {
+        schema = z.record(z.unknown());
+    }
+    else {
+        schema = z.unknown();
+    }
+    return field.required ? schema : schema.optional();
+}
+function literalFor(value) {
+    return z.literal(value);
+}
+//# sourceMappingURL=schema.js.map

package/dist/src/lib/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/lib/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,cAAc,CAAC,MAAqC,EAAE,MAA+B;IACnG,OAAO,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACnE,CAAC;AAED,+EAA+E;AAC/E,uFAAuF;AACvF,SAAS,WAAW,CAAC,MAAqC;IACxD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACvG,CAAC;AAED,SAAS,WAAW,CAAC,KAAoB;IACvC,IAAI,MAAoB,CAAC;IAEzB,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAA+E,CAAC,CAAC;IAC/I,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACnL,IAAI,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC;QACvC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC;QACvC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,GAAG,YAAY,CAAC;IACxB,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAClC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAChC,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;IAED,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAc,CAAC,CAAC;AACnC,CAAC"}

package/dist/src/lib/text.d.ts

@@ -0,0 +1,5 @@
+export declare function humanize(value: string): string;
+export declare function modalityForAction(action: string): "image" | "video" | "audio" | "utility";
+export declare function contractKey(service: string, action: string): string;
+export declare function routeAction(action: string): string;
+export declare function publicModelUrl(model: string): string;

package/dist/src/lib/text.js

@@ -0,0 +1,27 @@
+export function humanize(value) {
+    return value
+        .replace(/[_-]+/g, " ")
+        .replace(/\b\w/g, (char) => char.toUpperCase());
+}
+export function modalityForAction(action) {
+    if (action.includes("video") || action === "ai_avatar" || action === "motion_control" || action === "animate") {
+        return "video";
+    }
+    if (action.includes("image") || action.includes("background") || action === "create_character") {
+        return "image";
+    }
+    if (action.includes("audio") || action.includes("music") || action.includes("speech") || action.includes("sound") || action.includes("voice") || action.includes("dialogue")) {
+        return "audio";
+    }
+    return "utility";
+}
+export function contractKey(service, action) {
+    return `${service}/${action.replaceAll("_", "-")}`;
+}
+export function routeAction(action) {
+    return action.replaceAll("-", "_");
+}
+export function publicModelUrl(model) {
+    return `https://runapi.ai/pricing?model=${encodeURIComponent(model)}`;
+}
+//# sourceMappingURL=text.js.map

package/dist/src/lib/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/lib/text.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,KAAK;SACT,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,gBAAgB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9G,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,MAAM,KAAK,kBAAkB,EAAE,CAAC;QAC/F,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7K,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,MAAc;IACzD,OAAO,GAAG,OAAO,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,mCAAmC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;AACxE,CAAC"}

package/dist/src/lib/tool-response.d.ts

@@ -0,0 +1,6 @@
+export declare function jsonText(value: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};

package/dist/src/lib/tool-response.js

@@ -0,0 +1,11 @@
+export function jsonText(value) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(value, null, 2)
+            }
+        ]
+    };
+}
+//# sourceMappingURL=tool-response.js.map

package/dist/src/lib/tool-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-response.js","sourceRoot":"","sources":["../../../src/lib/tool-response.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;aACrC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/server-instructions.d.ts

@@ -0,0 +1 @@
+export declare const SERVER_INSTRUCTIONS: string;

package/dist/src/server-instructions.js

@@ -0,0 +1,66 @@
+export const SERVER_INSTRUCTIONS = `
+RunAPI gives this host model discovery, pricing lookup, task creation, task polling, balance checks, and LLM chat.
+
+Available tools:
+- list_models: browse models by modality, service, or action. Free, no API key required.
+- list_actions: list endpoint action names grouped by modality. Free, no API key required.
+- get_model_info: inspect params, constraints, and pricing snapshot for a model slug. Pass service and action when known to disambiguate models that support multiple endpoints. Free, no API key required.
+- check_pricing: inspect pricing snapshot for service + action + model. Free, no API key required.
+- check_balance: check account balance and spending. Requires API key.
+- create_task: create a media task and optionally poll for completion. Requires API key.
+- get_task: fetch current status and latest payload for an existing task. Requires API key.
+- chat: send messages to a RunAPI LLM endpoint. Requires API key.
+
+Global behavior:
+1. Use the user's language.
+2. Be concise. Do not narrate tool internals unless the user asks.
+3. Do not batch-ask. Ask at most one necessary follow-up before tool use.
+4. Do not mention infrastructure providers, hidden vendors, or implementation partners.
+5. Do not hardcode or guess model slugs. Use list_models and get_model_info.
+6. Do not quote memorized prices. Use check_pricing or link to https://runapi.ai/pricing.
+7. Present task results as task ID, status, output URLs, and cost fields when available.
+8. Do not describe generated media as if you inspected it.
+9. Do not paste raw JSON unless the user asks.
+
+Phase 0: API key check
+- Use free catalog tools even when no API key is configured.
+- Before authenticated tools, guide setup with RUNAPI_API_KEY or ~/.config/runapi/config.json.
+- If an authenticated tool returns an API key error, explain the setup and do not retry until the user has fixed configuration.
+
+Phase 1: Intent assessment
+- If the user is exploring, call list_models, list_actions, get_model_info, or check_pricing.
+- If the user asks to generate media, identify modality, service, action, model, and params from catalog tools.
+- If the user asks about an existing task, call get_task with service, action when known, and task_id.
+- If the user asks for LLM inference through RunAPI, use chat instead of create_task.
+
+Phase 2: Model selection
+- When the user names a model slug, use it after verifying with get_model_info.
+- If get_model_info returns ambiguous matches, call it again with the selected service and action before choosing params.
+- When the user does not name a model, call list_models with a modality/action filter.
+- Compare returned candidates by modality, supported inputs, likely quality/speed tradeoffs, and check_pricing results.
+- Ask one clarifying question only when required to choose a compatible model or required input.
+
+Phase 3: Task creation
+- Always verify params with get_model_info before create_task. Include service and action in get_model_info when they are known.
+- If get_model_info returns input_rules, follow them exactly before create_task.
+- Include model in create_task when the selected action requires or supports a model slug.
+- Confirm before expensive, long-running, or batch media requests.
+- For ordinary image requests, wait for completion unless the user wants submit-only behavior.
+- For long-running audio/video/batch work, consider wait=false when the host timeout is likely to interrupt the response, then tell the user to call get_task later.
+- Never retry create_task automatically after a timeout because the original task may still be processing.
+
+Phase 4: Result presentation
+- Show task ID, final status, output URLs, and cost fields when available.
+- If task output has multiple URLs, list them all.
+- If task is still processing, show the task ID and how to check it later.
+- Do not describe generated media content as if you inspected it.
+
+Phase 5: Error recovery
+- Missing or invalid key: explain RUNAPI_API_KEY and ~/.config/runapi/config.json setup.
+- Insufficient balance: tell the user to add balance in the RunAPI dashboard.
+- Rate limit: wait briefly before one retry only if the user confirms.
+- Service unavailable: use list_models to suggest another compatible RunAPI model.
+- Invalid params: call get_model_info, show valid fields, constraints, and input_rules, and ask for the corrected input.
+- Timeout: do not recreate the task automatically; tell the user to check status with get_task.
+`.trim();
+//# sourceMappingURL=server-instructions.js.map

package/dist/src/server-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-instructions.js","sourceRoot":"","sources":["../../src/server-instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgElC,CAAC,IAAI,EAAE,CAAC"}

package/dist/src/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/src/server.js

@@ -0,0 +1,20 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PACKAGE_NAME, PACKAGE_VERSION } from "./constants.js";
+import { SERVER_INSTRUCTIONS } from "./server-instructions.js";
+import { registerAuthenticatedTools } from "./tools/authenticated.js";
+import { registerCatalogTools } from "./tools/catalog.js";
+export function createServer() {
+    const server = new McpServer({
+        name: PACKAGE_NAME,
+        version: PACKAGE_VERSION
+    }, {
+        instructions: SERVER_INSTRUCTIONS,
+        capabilities: {
+            tools: {}
+        }
+    });
+    registerCatalogTools(server);
+    registerAuthenticatedTools(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,eAAe;KACzB,EACD;QACE,YAAY,EAAE,mBAAmB;QACjC,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAEnC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/tools/authenticated-handlers.d.ts

@@ -0,0 +1,77 @@
+import { type RunApiClient } from "../lib/runapi-client.js";
+import type { ChatMessage, RunApiTaskResponse } from "../types.js";
+export type ProgressSender = (message: {
+    progressToken: string | number;
+    progress: number;
+    total: number;
+    message: string;
+}) => Promise<void> | void;
+export declare function checkBalanceHandler(client: Pick<RunApiClient, "balance">): Promise<unknown>;
+export declare function createTaskHandler(input: {
+    service: string;
+    action: string;
+    model?: string;
+    params?: Record<string, unknown>;
+    wait?: boolean;
+    timeout_ms?: number;
+    poll_interval_ms?: number;
+}, client: Pick<RunApiClient, "createTask" | "pollTask">, sendProgress?: ProgressSender, progressToken?: string | number): Promise<{
+    error: string;
+    hint: string;
+    created?: undefined;
+    task_id?: undefined;
+    status?: undefined;
+    result?: undefined;
+} | {
+    created: RunApiTaskResponse;
+    task_id: string | undefined;
+    status: string;
+    error?: undefined;
+    hint?: undefined;
+    result?: undefined;
+} | {
+    task_id: string;
+    status: string;
+    result: RunApiTaskResponse;
+    error?: undefined;
+    hint?: undefined;
+    created?: undefined;
+} | {
+    error: string;
+    hint?: undefined;
+    created?: undefined;
+    task_id?: undefined;
+    status?: undefined;
+    result?: undefined;
+}>;
+export declare function getTaskHandler(input: {
+    service: string;
+    action?: string;
+    task_id: string;
+}, client: Pick<RunApiClient, "getTask">): Promise<{
+    task_id: string;
+    status: string;
+    task: RunApiTaskResponse;
+    error?: undefined;
+} | {
+    error: string;
+    task_id?: undefined;
+    status?: undefined;
+    task?: undefined;
+}>;
+export declare function chatHandler(input: {
+    model: string;
+    messages: ChatMessage[];
+    max_tokens?: number;
+    temperature?: number;
+    api?: "messages" | "chat_completions";
+}, client: Pick<RunApiClient, "chat">): Promise<{
+    text: string | undefined;
+    response: unknown;
+    error?: undefined;
+} | {
+    error: string;
+    text?: undefined;
+    response?: undefined;
+}>;
+export declare function defaultTimeout(action: string): number;

package/dist/src/tools/authenticated-handlers.js

@@ -0,0 +1,144 @@
+import { findModelForAction } from "../lib/contract.js";
+import { friendlyError } from "../lib/errors.js";
+import { validateInputRules } from "../lib/input-rules.js";
+import { taskIdFromResponse, taskStatus } from "../lib/runapi-client.js";
+import { validateParams } from "../lib/schema.js";
+export async function checkBalanceHandler(client) {
+    try {
+        return await client.balance();
+    }
+    catch (error) {
+        return { error: friendlyError(error) };
+    }
+}
+export async function createTaskHandler(input, client, sendProgress, progressToken) {
+    try {
+        const info = findModelForAction(input.service, input.action, input.model);
+        if (!info) {
+            return {
+                error: "Unsupported RunAPI service/action/model combination.",
+                hint: "Call list_models first to choose a supported model."
+            };
+        }
+        const body = validateParams(info.fields, {
+            ...(input.params || {}),
+            ...(input.model ? { model: input.model } : {})
+        });
+        const ruleError = validateInputRules(info, body);
+        if (ruleError) {
+            return {
+                error: `Invalid RunAPI parameters: ${ruleError}`,
+                hint: "Call get_model_info with service and action to inspect input_rules before create_task."
+            };
+        }
+        const created = await client.createTask(input.service, input.action, body);
+        const taskId = taskIdFromResponse(created);
+        if (!input.wait || !taskId) {
+            return {
+                created,
+                task_id: taskId,
+                status: taskStatus(created)
+            };
+        }
+        const timeout = input.timeout_ms ?? defaultTimeout(input.action);
+        const startedAt = Date.now();
+        const completed = await client.pollTask(input.service, taskId, input.action, {
+            timeoutMs: timeout,
+            intervalMs: input.poll_interval_ms ?? 5_000,
+            onProgress: async (task) => {
+                const elapsed = Date.now() - startedAt;
+                await sendProgress?.({
+                    progressToken: progressToken || taskId,
+                    progress: Math.min(elapsed, timeout),
+                    total: timeout,
+                    message: `RunAPI task ${taskId}: ${taskStatus(task)}`
+                });
+            }
+        });
+        return {
+            task_id: taskId,
+            status: taskStatus(completed),
+            result: completed
+        };
+    }
+    catch (error) {
+        return { error: friendlyError(error) };
+    }
+}
+export async function getTaskHandler(input, client) {
+    try {
+        const task = await client.getTask(input.service, input.task_id, input.action);
+        return {
+            task_id: input.task_id,
+            status: taskStatus(task),
+            task
+        };
+    }
+    catch (error) {
+        return { error: friendlyError(error) };
+    }
+}
+export async function chatHandler(input, client) {
+    try {
+        const response = await client.chat(input);
+        return {
+            text: extractChatText(response),
+            response
+        };
+    }
+    catch (error) {
+        return { error: friendlyError(error) };
+    }
+}
+export function defaultTimeout(action) {
+    if (action.includes("video")) {
+        return 300_000;
+    }
+    if (["music", "audio", "speech", "sound", "voice"].some((term) => action.includes(term))) {
+        return 300_000;
+    }
+    if (action.includes("image")) {
+        return 120_000;
+    }
+    return 30_000;
+}
+function extractChatText(response) {
+    if (!response || typeof response !== "object") {
+        return undefined;
+    }
+    const record = response;
+    const content = record.content;
+    if (Array.isArray(content)) {
+        const text = content.map((item) => {
+            if (!item || typeof item !== "object") {
+                return undefined;
+            }
+            const value = item.text;
+            return typeof value === "string" ? value : undefined;
+        }).filter((value) => Boolean(value)).join("");
+        if (text.length > 0) {
+            return text;
+        }
+    }
+    const choices = record.choices;
+    if (Array.isArray(choices)) {
+        const text = choices.map((choice) => {
+            if (!choice || typeof choice !== "object") {
+                return undefined;
+            }
+            const choiceRecord = choice;
+            const message = choiceRecord.message;
+            if (message && typeof message === "object") {
+                const value = message.content;
+                return typeof value === "string" ? value : undefined;
+            }
+            const value = choiceRecord.text;
+            return typeof value === "string" ? value : undefined;
+        }).filter((value) => Boolean(value)).join("");
+        if (text.length > 0) {
+            return text;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=authenticated-handlers.js.map

package/dist/src/tools/authenticated-handlers.js.map

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

package/dist/src/tools/authenticated.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RunApiClient } from "../lib/runapi-client.js";
+export declare function registerAuthenticatedTools(server: McpServer, client?: RunApiClient): void;

package/dist/src/tools/authenticated.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { RunApiClient } from "../lib/runapi-client.js";
+import { jsonText } from "../lib/tool-response.js";
+import { chatHandler, checkBalanceHandler, createTaskHandler, getTaskHandler } from "./authenticated-handlers.js";
+export function registerAuthenticatedTools(server, client = new RunApiClient()) {
+    server.tool("check_balance", "Return the authenticated RunAPI account balance and spending metrics.", {}, async () => {
+        return jsonText(await checkBalanceHandler(client));
+    });
+    server.tool("create_task", "Create a RunAPI media task and optionally poll until completion.", {
+        service: z.string().describe("RunAPI service slug returned by list_models"),
+        action: z.string().describe("RunAPI endpoint name, for example text_to_image"),
+        model: z.string().optional().describe("RunAPI model slug"),
+        params: z.record(z.unknown()).default({}).describe("Endpoint parameters validated against data/contract.json where constrained."),
+        wait: z.boolean().default(true).describe("Poll until the task reaches a terminal status."),
+        timeout_ms: z.number().int().positive().optional(),
+        poll_interval_ms: z.number().int().positive().optional()
+    }, async ({ service, action, model, params, wait, timeout_ms, poll_interval_ms }, extra) => {
+        const progressToken = extra._meta?.progressToken;
+        const result = await createTaskHandler({ service, action, model, params, wait, timeout_ms, poll_interval_ms }, client, async (progress) => {
+            await extra.sendNotification?.({
+                method: "notifications/progress",
+                params: progress
+            });
+        }, progressToken);
+        return jsonText(result);
+    });
+    server.tool("get_task", "Fetch the current status and latest payload for an existing RunAPI task.", {
+        service: z.string(),
+        action: z.string().optional().describe("RunAPI endpoint name. Provide this when using media task routes."),
+        task_id: z.string()
+    }, async ({ service, action, task_id }) => {
+        return jsonText(await getTaskHandler({ service, action, task_id }, client));
+    });
+    server.tool("chat", "Send a prompt to a RunAPI LLM endpoint and return the response with usage metadata when available.", {
+        model: z.string().describe("RunAPI LLM model slug"),
+        messages: z.array(z.object({
+            role: z.enum(["system", "user", "assistant"]),
+            content: z.string()
+        })),
+        max_tokens: z.number().int().positive().optional(),
+        temperature: z.number().min(0).max(2).optional(),
+        api: z.enum(["messages", "chat_completions"]).default("messages")
+    }, async ({ model, messages, max_tokens, temperature, api }) => {
+        return jsonText(await chatHandler({
+            model,
+            messages: messages,
+            max_tokens,
+            temperature,
+            api
+        }, client));
+    });
+}
+//# sourceMappingURL=authenticated.js.map