@runapi.ai/mcp-core 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+export type RunApiConfig = {
+    apiKey?: string;
+    baseUrl: string;
+};
+export declare function configPath(): string;
+export declare function loadConfig(env?: NodeJS.ProcessEnv): RunApiConfig;
+export declare function requireApiKey(config?: RunApiConfig): string;

package/dist/config.js

@@ -0,0 +1,32 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { DEFAULT_BASE_URL, RUNAPI_API_KEY_ENV } from "./constants.js";
+export function configPath() {
+    return path.join(os.homedir(), ".config", "runapi", "config.json");
+}
+export function loadConfig(env = process.env) {
+    const file = readConfigFile();
+    const apiKey = env[RUNAPI_API_KEY_ENV]?.trim() || file.apiKey || file.api_key || undefined;
+    const baseUrl = env.RUNAPI_BASE_URL?.trim() || file.baseUrl || file.base_url || DEFAULT_BASE_URL;
+    return { apiKey, baseUrl };
+}
+export function requireApiKey(config = loadConfig()) {
+    if (!config.apiKey) {
+        throw new Error("RunAPI API key is required. Sign up at https://runapi.ai, go to Dashboard > API Keys, then: mkdir -p ~/.config/runapi && echo '{\"api_key\":\"YOUR_KEY\"}' > ~/.config/runapi/config.json");
+    }
+    return config.apiKey;
+}
+function readConfigFile() {
+    const file = configPath();
+    if (!fs.existsSync(file)) {
+        return {};
+    }
+    try {
+        return JSON.parse(fs.readFileSync(file, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AActE,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC;IAC3F,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,IAAI,gBAAgB,CAAC;IAEjG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAM,GAAG,UAAU,EAAE;IACjD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,2LAA2L,CAAC,CAAC;IAC/M,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAe,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const CORE_PACKAGE_NAME = "@runapi.ai/mcp-core";
+export declare const CORE_PACKAGE_VERSION = "0.1.0";
+export declare const DEFAULT_BASE_URL = "https://runapi.ai";
+export declare const RUNAPI_API_KEY_ENV = "RUNAPI_API_KEY";
+export declare const USER_AGENT = "@runapi.ai/mcp-core/0.1.0";

package/dist/constants.js

@@ -0,0 +1,6 @@
+export const CORE_PACKAGE_NAME = "@runapi.ai/mcp-core";
+export const CORE_PACKAGE_VERSION = "0.1.0";
+export const DEFAULT_BASE_URL = "https://runapi.ai";
+export const RUNAPI_API_KEY_ENV = "RUNAPI_API_KEY";
+export const USER_AGENT = `${CORE_PACKAGE_NAME}/${CORE_PACKAGE_VERSION}`;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AACvD,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAC5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,iBAAiB,IAAI,oBAAoB,EAAE,CAAC"}

package/dist/contract.d.ts

@@ -0,0 +1,20 @@
+import type { Contract, ContractAction, ContractField, ModelInfo } from "./types.js";
+export declare function listContractModels(source: Contract): ModelInfo[];
+export declare function listActionGroups(source: Contract): {
+    modality: string;
+    actions: string[];
+}[];
+export declare function findAction(service: string, action: string, source: Contract): ContractAction | undefined;
+export declare function findModel(model: string, source: Contract): ModelInfo | undefined;
+export declare function findModels(model: string, source: Contract): ModelInfo[];
+export declare function findModelForAction(service: string, action: string, model: string | undefined, source: Contract): ModelInfo | undefined;
+export declare function fieldsForModel(action: ContractAction, model: string): Record<string, ContractField>;
+export declare function fieldSummary(fields: Record<string, ContractField>): {
+    name: string;
+    required: boolean;
+    enum: unknown[] | undefined;
+    default: unknown;
+    min: number | undefined;
+    max: number | undefined;
+    type: string | undefined;
+}[];

package/dist/contract.js

@@ -0,0 +1,79 @@
+import { contractKey, modalityForAction, routeAction } from "./text.js";
+export function listContractModels(source) {
+    return Object.entries(source.actions).flatMap(([key, action]) => {
+        const [service, actionSlug] = key.split("/");
+        return action.models.map((model) => ({
+            service,
+            action: action.endpoint,
+            route_action: routeAction(actionSlug),
+            provider: action.provider,
+            model_line: action.model,
+            model,
+            fields: fieldsForModel(action, model)
+        }));
+    });
+}
+export function listActionGroups(source) {
+    const groups = new Map();
+    for (const action of Object.values(source.actions)) {
+        const modality = modalityForAction(action.endpoint);
+        if (!groups.has(modality)) {
+            groups.set(modality, new Set());
+        }
+        groups.get(modality)?.add(action.endpoint);
+    }
+    return [...groups.entries()].map(([modality, actions]) => ({
+        modality,
+        actions: [...actions].sort()
+    }));
+}
+export function findAction(service, action, source) {
+    const direct = source.actions[contractKey(service, action)];
+    if (direct) {
+        return direct;
+    }
+    return Object.entries(source.actions).find(([key, value]) => {
+        const [candidateService] = key.split("/");
+        return candidateService === service && value.endpoint === action;
+    })?.[1];
+}
+export function findModel(model, source) {
+    return listContractModels(source).find((entry) => entry.model === model);
+}
+export function findModels(model, source) {
+    return listContractModels(source).filter((entry) => entry.model === model);
+}
+export function findModelForAction(service, action, model, source) {
+    const entry = findAction(service, action, source);
+    if (!entry) {
+        return undefined;
+    }
+    const selectedModel = model || entry.models[0];
+    if (!entry.models.includes(selectedModel)) {
+        return undefined;
+    }
+    return {
+        service,
+        action: entry.endpoint,
+        route_action: entry.endpoint,
+        provider: entry.provider,
+        model_line: entry.model,
+        model: selectedModel,
+        fields: fieldsForModel(entry, selectedModel)
+    };
+}
+export function fieldsForModel(action, model) {
+    return action.fields_by_model[model] || action.fields_by_model.__nil_model__ || {};
+}
+export function fieldSummary(fields) {
+    return Object.entries(fields).map(([name, field]) => ({
+        name,
+        required: Boolean(field.required),
+        enum: field.enum,
+        default: field.default,
+        min: field.min ?? field.minimum,
+        max: field.max ?? field.maximum,
+        type: field.type
+    }));
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExE,MAAM,UAAU,kBAAkB,CAAC,MAAgB;IACjD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE;QAC9D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACnC,OAAO;YACP,MAAM,EAAE,MAAM,CAAC,QAAQ;YACvB,YAAY,EAAE,WAAW,CAAC,UAAU,CAAC;YACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,KAAK;YACxB,KAAK;YACL,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC;SACtC,CAAC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAgB;IAC/C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE9C,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACzD,QAAQ;QACR,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE;KAC7B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,MAAc,EAAE,MAAgB;IAC1E,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC1D,MAAM,CAAC,gBAAgB,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,OAAO,gBAAgB,KAAK,OAAO,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC;IACnE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACV,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,MAAgB;IACvD,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,MAAgB;IACxD,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,MAAc,EAAE,KAAyB,EAAE,MAAgB;IAC7G,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,OAAO;QACP,MAAM,EAAE,KAAK,CAAC,QAAQ;QACtB,YAAY,EAAE,KAAK,CAAC,QAAQ;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,KAAK;QACvB,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE,aAAa,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAsB,EAAE,KAAa;IAClE,OAAO,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,eAAe,CAAC,aAAa,IAAI,EAAE,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAqC;IAChE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI;QACJ,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QACjC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO;QAC/B,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO;QAC/B,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,10 @@
+export declare class RunApiClientError extends Error {
+    readonly status?: number | undefined;
+    readonly details?: unknown | undefined;
+    constructor(message: string, status?: number | undefined, details?: unknown | undefined);
+}
+export declare class PollTimeoutError extends Error {
+    constructor(message: string);
+}
+export declare function friendlyError(error: unknown): string;
+export declare function errorFromResponse(response: Response): Promise<RunApiClientError>;

package/dist/errors.js

@@ -0,0 +1,88 @@
+export class RunApiClientError extends Error {
+    status;
+    details;
+    constructor(message, status, details) {
+        super(message);
+        this.status = status;
+        this.details = details;
+        this.name = "RunApiClientError";
+    }
+}
+export class PollTimeoutError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PollTimeoutError";
+    }
+}
+export function friendlyError(error) {
+    if (error instanceof RunApiClientError) {
+        switch (error.status) {
+            case 401:
+                return "RunAPI rejected the API key. Check RUNAPI_API_KEY or ~/.config/runapi/config.json.";
+            case 402:
+                return "The RunAPI account has insufficient credits. Add credits in the RunAPI dashboard, then retry.";
+            case 429:
+                return "RunAPI rate limited this request. Wait briefly, then retry.";
+            case 503:
+                return "This RunAPI service is temporarily unavailable. Retry later or choose another model.";
+            default:
+                return error.message;
+        }
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return "RunAPI request failed.";
+}
+export async function errorFromResponse(response) {
+    const text = await response.text();
+    let body = text;
+    try {
+        body = text ? JSON.parse(text) : undefined;
+    }
+    catch {
+        body = text;
+    }
+    return new RunApiClientError(extractMessage(body) || defaultMessage(response.status), response.status, body);
+}
+function extractMessage(body) {
+    if (typeof body === "string") {
+        return body.trim() || undefined;
+    }
+    if (!body || typeof body !== "object") {
+        return undefined;
+    }
+    const record = body;
+    for (const key of ["message", "detail", "error", "msg"]) {
+        const value = record[key];
+        if (typeof value === "string" && value.trim()) {
+            return value.trim();
+        }
+        const nested = extractMessage(value);
+        if (nested) {
+            return nested;
+        }
+    }
+    return undefined;
+}
+function defaultMessage(status) {
+    switch (status) {
+        case 400:
+            return "RunAPI rejected the request parameters.";
+        case 401:
+            return "RunAPI API key is invalid or missing.";
+        case 402:
+            return "Insufficient RunAPI credits.";
+        case 404:
+            return "RunAPI resource was not found.";
+        case 422:
+            return "RunAPI could not validate the request.";
+        case 429:
+            return "RunAPI rate limit exceeded.";
+        case 503:
+            return "RunAPI service unavailable.";
+        default:
+            return `RunAPI request failed with HTTP ${status}.`;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./types.js";
+export * from "./constants.js";
+export * from "./config.js";
+export * from "./errors.js";
+export * from "./text.js";
+export * from "./tool-response.js";
+export * from "./schema.js";
+export * from "./contract.js";
+export * from "./pricing.js";
+export { validateInputRules } from "./input-rules.js";
+export * from "./runapi-client.js";
+export * from "./server.js";

package/dist/index.js

@@ -0,0 +1,13 @@
+export * from "./types.js";
+export * from "./constants.js";
+export * from "./config.js";
+export * from "./errors.js";
+export * from "./text.js";
+export * from "./tool-response.js";
+export * from "./schema.js";
+export * from "./contract.js";
+export * from "./pricing.js";
+export { validateInputRules } from "./input-rules.js";
+export * from "./runapi-client.js";
+export * from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC"}

package/dist/input-rules.d.ts

@@ -0,0 +1,3 @@
+import type { InputRule } from "./types.js";
+export type { InputRule } from "./types.js";
+export declare function validateInputRules(rules: InputRule[], params: Record<string, unknown>): string | undefined;

package/dist/input-rules.js

@@ -0,0 +1,35 @@
+export function validateInputRules(rules, params) {
+    if (rules.length === 0) {
+        return undefined;
+    }
+    const controllingFields = new Set(rules.flatMap((rule) => Object.keys(rule.when)));
+    for (const field of controllingFields) {
+        if (!hasValue(params[field])) {
+            return `${field} is required to choose a valid parameter shape.`;
+        }
+    }
+    const rule = rules.find((candidate) => Object.entries(candidate.when).every(([field, value]) => params[field] === value));
+    if (!rule) {
+        return undefined;
+    }
+    const missing = rule.required.filter((field) => !hasValue(params[field]));
+    const presentForbidden = rule.forbidden.filter((field) => hasValue(params[field]));
+    if (missing.length === 0 && presentForbidden.length === 0) {
+        return undefined;
+    }
+    const parts = [];
+    if (missing.length > 0) {
+        parts.push(`requires ${missing.join(", ")}`);
+    }
+    if (presentForbidden.length > 0) {
+        parts.push(`must not include ${presentForbidden.join(", ")}`);
+    }
+    return `${formatWhen(rule.when)} ${parts.join(" and ")}.`;
+}
+function hasValue(value) {
+    return value !== undefined && value !== null && !(typeof value === "string" && value.trim() === "");
+}
+function formatWhen(when) {
+    return Object.entries(when).map(([field, value]) => `${field}=${String(value)}`).join(", ");
+}
+//# sourceMappingURL=input-rules.js.map

package/dist/input-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-rules.js","sourceRoot":"","sources":["../src/input-rules.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,kBAAkB,CAAC,KAAkB,EAAE,MAA+B;IACpF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnF,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;QACtC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC7B,OAAO,GAAG,KAAK,iDAAiD,CAAC;QACnE,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC;IAC1H,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1E,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,EAAE,CAAC;IACjB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,oBAAoB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;AAC5D,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACtG,CAAC;AAED,SAAS,UAAU,CAAC,IAA6B;IAC/C,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9F,CAAC"}

package/dist/pricing.d.ts

@@ -0,0 +1,6 @@
+import type { ModelInfo, PricingConfig } from "./types.js";
+export declare function priceForModel(info: ModelInfo, source: PricingConfig): {
+    pricing: Record<string, unknown> | undefined;
+    pricing_source: string;
+    pricing_url: string;
+};

package/dist/pricing.js

@@ -0,0 +1,44 @@
+export function priceForModel(info, source) {
+    const key = pricingKey(info);
+    const endpoint = source.endpoints?.[key];
+    const hasPrice = endpoint ? hasPriceData(endpoint) : false;
+    const markup = effectiveMarkup(key, info.provider, source);
+    return {
+        pricing: endpoint && hasPrice ? presentPrice(endpoint, markup) : undefined,
+        pricing_source: hasPrice ? "build-time pricing snapshot" : "pricing page",
+        pricing_url: "https://runapi.ai/pricing"
+    };
+}
+function pricingKey(info) {
+    return `${info.provider}/${info.model_line}/${info.model}/${info.action}`;
+}
+function effectiveMarkup(key, provider, source) {
+    return source.endpoint_markup?.[key] ?? source.provider_markup?.[provider] ?? source.markup_rate ?? 1;
+}
+function hasPriceData(endpoint) {
+    return Object.values(endpoint).some((value) => value !== undefined && value !== null);
+}
+function presentPrice(endpoint, markup) {
+    const result = {};
+    for (const [name, value] of Object.entries(endpoint)) {
+        if (name === "cost_billing_config") {
+            result.billing_config = presentBillingConfig(endpoint.cost_billing_config, markup);
+            continue;
+        }
+        if (typeof value === "number") {
+            const publicName = name.replace(/^cost_/, "");
+            result[publicName] = Number.isInteger(value * markup) ? value * markup : Math.ceil(value * markup);
+        }
+    }
+    return result;
+}
+function presentBillingConfig(config, markup) {
+    if (!config) {
+        return undefined;
+    }
+    return {
+        key: config.key,
+        overrides: Object.fromEntries(Object.entries(config.overrides || {}).map(([key, value]) => [key, value * markup]))
+    };
+}
+//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,IAAe,EAAE,MAAqB;IAClE,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3D,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE3D,OAAO;QACL,OAAO,EAAE,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QAC1E,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,cAAc;QACzE,WAAW,EAAE,2BAA2B;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAe;IACjC,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;AAC5E,CAAC;AAED,SAAS,eAAe,CAAC,GAAW,EAAE,QAAgB,EAAE,MAAqB;IAC3E,OAAO,MAAM,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;AACxG,CAAC;AAED,SAAS,YAAY,CAAC,QAAyB;IAC7C,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,YAAY,CAAC,QAAyB,EAAE,MAAc;IAC7D,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,IAAI,IAAI,KAAK,qBAAqB,EAAE,CAAC;YACnC,MAAM,CAAC,cAAc,GAAG,oBAAoB,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;YACnF,SAAS;QACX,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC9C,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,oBAAoB,CAAC,MAA8C,EAAE,MAAc;IAC1F,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;KACnH,CAAC;AACJ,CAAC"}

package/dist/runapi-client.d.ts

@@ -0,0 +1,17 @@
+import { type RunApiConfig } from "./config.js";
+import type { PollingOptions, RunApiPromptsResponse, RunApiTaskResponse, SearchPromptsParams } from "./types.js";
+export declare class RunApiClient {
+    private readonly config;
+    private readonly fetchImpl;
+    private readonly userAgent;
+    constructor(config?: RunApiConfig, fetchImpl?: typeof fetch, userAgent?: string);
+    listModels(): Promise<unknown>;
+    searchPrompts(params?: SearchPromptsParams): Promise<RunApiPromptsResponse>;
+    balance(): Promise<unknown>;
+    createTask(service: string, action: string, params: Record<string, unknown>): Promise<RunApiTaskResponse>;
+    getTask(service: string, taskId: string, action?: string): Promise<RunApiTaskResponse>;
+    pollTask(service: string, taskId: string, action?: string, options?: PollingOptions): Promise<RunApiTaskResponse>;
+    private request;
+}
+export declare function taskStatus(task?: RunApiTaskResponse): string;
+export declare function taskIdFromResponse(task: RunApiTaskResponse): string | undefined;

package/dist/runapi-client.js

@@ -0,0 +1,115 @@
+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;
+    userAgent;
+    constructor(config = loadConfig(), fetchImpl = fetch, userAgent = USER_AGENT) {
+        this.config = config;
+        this.fetchImpl = fetchImpl;
+        this.userAgent = userAgent;
+    }
+    async listModels() {
+        return this.request("GET", "/v1/models", { auth: false });
+    }
+    async searchPrompts(params = {}) {
+        const query = new URLSearchParams();
+        appendQuery(query, "modality", params.modality);
+        appendQuery(query, "category", params.category);
+        appendQuery(query, "tags", params.tags?.join(","));
+        appendQuery(query, "q", params.q);
+        appendQuery(query, "model", params.model);
+        appendQuery(query, "featured", params.featured);
+        appendQuery(query, "page", params.page);
+        appendQuery(query, "per_page", params.per_page);
+        const suffix = query.size > 0 ? `?${query.toString()}` : "";
+        return this.request("GET", `/api/v1/prompts${suffix}`, { 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 request(method, requestPath, options = {}) {
+        const url = new URL(requestPath, this.config.baseUrl.replace(/\/+$/, ""));
+        const headers = {
+            accept: "application/json",
+            "user-agent": this.userAgent,
+            ...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, "_");
+}
+function appendQuery(query, key, value) {
+    if (value === undefined || value === "") {
+        return;
+    }
+    query.set(key, String(value));
+}
+//# sourceMappingURL=runapi-client.js.map

package/dist/runapi-client.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,4 @@
+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">;
+export declare function zodShapeForFields(fields: Record<string, ContractField>): Record<string, z.ZodTypeAny>;

package/dist/schema.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+export function validateParams(fields, params) {
+    return z.object(zodShapeForFields(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.
+export function zodShapeForFields(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/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/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,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACzE,CAAC;AAED,+EAA+E;AAC/E,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAAC,MAAqC;IACrE,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/server.d.ts

@@ -0,0 +1,24 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Contract, ContractField, InputRule, PricingConfig } from "./types.js";
+import { RunApiClient } from "./runapi-client.js";
+export type ModelServerTool = {
+    name: string;
+    description: string;
+    service: string;
+    action: string;
+    models: string[];
+    inputSchema: Record<string, ContractField>;
+};
+export type CreateModelServerOptions = {
+    name: string;
+    version: string;
+    lineSlug: string;
+    contract: Contract;
+    pricing: PricingConfig;
+    inputRules: Record<string, InputRule[]>;
+    tools: ModelServerTool[];
+    client?: RunApiClient;
+    instructions?: string;
+};
+export declare function createModelServer(options: CreateModelServerOptions): McpServer;
+export declare function defaultTimeout(action: string): number;

package/dist/server.js

@@ -0,0 +1,127 @@
+import { z } from "zod";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { findModelForAction } from "./contract.js";
+import { priceForModel } from "./pricing.js";
+import { validateInputRules } from "./input-rules.js";
+import { validateParams, zodShapeForFields } from "./schema.js";
+import { RunApiClient, taskIdFromResponse, taskStatus } from "./runapi-client.js";
+import { friendlyError } from "./errors.js";
+import { jsonText } from "./tool-response.js";
+// Builds a per-model RunAPI MCP server from injected catalog data — no disk
+// access. Each tool creates and optionally polls a RunAPI task for its
+// service/action, validating params against the tool's inputSchema and the
+// endpoint's cross-field input rules.
+export function createModelServer(options) {
+    const { name, version, lineSlug, contract, pricing, inputRules, tools, client = new RunApiClient() } = options;
+    const server = new McpServer({
+        name,
+        version
+    }, {
+        instructions: options.instructions ?? defaultInstructions(lineSlug),
+        capabilities: {
+            tools: {}
+        }
+    });
+    for (const tool of tools) {
+        server.tool(tool.name, tool.description, toolShape(tool), async (args, extra) => {
+            const { wait = true, timeout_ms, poll_interval_ms, model, ...params } = args;
+            try {
+                const info = findModelForAction(tool.service, tool.action, model, contract);
+                if (!info) {
+                    return jsonText({
+                        error: "Unsupported RunAPI service/action/model combination.",
+                        hint: "This model server was generated for a specific model line; verify the requested model."
+                    });
+                }
+                const body = validateParams(tool.inputSchema, {
+                    ...params,
+                    ...(model ? { model } : {})
+                });
+                const ruleError = validateInputRules(inputRules[tool.action] ?? [], body);
+                if (ruleError) {
+                    return jsonText({
+                        error: `Invalid RunAPI parameters: ${ruleError}`,
+                        hint: "Adjust the parameters to satisfy the endpoint input rules before retrying."
+                    });
+                }
+                const price = priceForModel(info, pricing);
+                const created = await client.createTask(tool.service, tool.action, body);
+                const taskId = taskIdFromResponse(created);
+                if (!wait || !taskId) {
+                    return jsonText({
+                        created,
+                        task_id: taskId,
+                        status: taskStatus(created),
+                        price
+                    });
+                }
+                const timeout = timeout_ms ?? defaultTimeout(tool.action);
+                const startedAt = Date.now();
+                const completed = await client.pollTask(tool.service, taskId, tool.action, {
+                    timeoutMs: timeout,
+                    intervalMs: poll_interval_ms ?? 5_000,
+                    onProgress: async (task) => {
+                        const elapsed = Date.now() - startedAt;
+                        await extra.sendNotification?.({
+                            method: "notifications/progress",
+                            params: {
+                                progressToken: extra._meta?.progressToken ?? taskId,
+                                progress: Math.min(elapsed, timeout),
+                                total: timeout,
+                                message: `RunAPI task ${taskId}: ${taskStatus(task)}`
+                            }
+                        });
+                    }
+                });
+                return jsonText({
+                    task_id: taskId,
+                    status: taskStatus(completed),
+                    result: completed,
+                    price
+                });
+            }
+            catch (error) {
+                return jsonText({ error: friendlyError(error) });
+            }
+        });
+    }
+    return server;
+}
+function toolShape(tool) {
+    const shape = {
+        ...zodShapeForFields(tool.inputSchema),
+        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()
+    };
+    if (tool.models.length > 0) {
+        shape.model = z.enum(tool.models).optional().describe("RunAPI model slug for this model line.");
+    }
+    return shape;
+}
+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 defaultInstructions(lineSlug) {
+    return [
+        `RunAPI MCP server for the ${lineSlug} model line.`,
+        "",
+        "Each tool creates a RunAPI media task and optionally polls until completion.",
+        "Behavior:",
+        "1. Use the user's language and be concise.",
+        "2. Confirm before expensive, long-running, or batch requests.",
+        "3. Present results as task ID, status, output URLs, and cost fields when available.",
+        "4. Do not describe generated media as if you inspected it.",
+        "5. On an API key error, guide the user to configure RUNAPI_API_KEY or ~/.config/runapi/config.json."
+    ].join("\n");
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AA0B9C,4EAA4E;AAC5E,uEAAuE;AACvE,2EAA2E;AAC3E,sCAAsC;AACtC,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,YAAY,EAAE,EAAE,GAAG,OAAO,CAAC;IAE/G,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI;QACJ,OAAO;KACR,EACD;QACE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,mBAAmB,CAAC,QAAQ,CAAC;QACnE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;YAC9E,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,UAAU,EAAE,gBAAgB,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,GAAG,IAKvE,CAAC;YAEF,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;gBAC5E,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,OAAO,QAAQ,CAAC;wBACd,KAAK,EAAE,sDAAsD;wBAC7D,IAAI,EAAE,wFAAwF;qBAC/F,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE;oBAC5C,GAAG,MAAM;oBACT,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC5B,CAAC,CAAC;gBAEH,MAAM,SAAS,GAAG,kBAAkB,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;gBAC1E,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO,QAAQ,CAAC;wBACd,KAAK,EAAE,8BAA8B,SAAS,EAAE;wBAChD,IAAI,EAAE,4EAA4E;qBACnF,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC3C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACzE,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;gBAE3C,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBACrB,OAAO,QAAQ,CAAC;wBACd,OAAO;wBACP,OAAO,EAAE,MAAM;wBACf,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC;wBAC3B,KAAK;qBACN,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM,OAAO,GAAG,UAAU,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC7B,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;oBACzE,SAAS,EAAE,OAAO;oBAClB,UAAU,EAAE,gBAAgB,IAAI,KAAK;oBACrC,UAAU,EAAE,KAAK,EAAE,IAAwB,EAAE,EAAE;wBAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;wBACvC,MAAM,KAAK,CAAC,gBAAgB,EAAE,CAAC;4BAC7B,MAAM,EAAE,wBAAwB;4BAChC,MAAM,EAAE;gCACN,aAAa,EAAE,KAAK,CAAC,KAAK,EAAE,aAAa,IAAI,MAAM;gCACnD,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC;gCACpC,KAAK,EAAE,OAAO;gCACd,OAAO,EAAE,eAAe,MAAM,KAAK,UAAU,CAAC,IAAI,CAAC,EAAE;6BACtD;yBACF,CAAC,CAAC;oBACL,CAAC;iBACF,CAAC,CAAC;gBAEH,OAAO,QAAQ,CAAC;oBACd,OAAO,EAAE,MAAM;oBACf,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC;oBAC7B,MAAM,EAAE,SAAS;oBACjB,KAAK;iBACN,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,QAAQ,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,IAAqB;IACtC,MAAM,KAAK,GAAiC;QAC1C,GAAG,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC;QACtC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QAC1F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAClD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KACzD,CAAC;IAEF,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAA+B,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC,CAAC;IAC3H,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACzF,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAgB;IAC3C,OAAO;QACL,6BAA6B,QAAQ,cAAc;QACnD,EAAE;QACF,8EAA8E;QAC9E,WAAW;QACX,4CAA4C;QAC5C,+DAA+D;QAC/D,qFAAqF;QACrF,4DAA4D;QAC5D,qGAAqG;KACtG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/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/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/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/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/tool-response.d.ts

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

package/dist/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/tool-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-response.js","sourceRoot":"","sources":["../src/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/types.d.ts

@@ -0,0 +1,115 @@
+export type ContractField = {
+    required?: boolean;
+    enum?: unknown[];
+    default?: unknown;
+    min?: number;
+    max?: number;
+    minimum?: number;
+    maximum?: number;
+    type?: string;
+    description?: string;
+};
+export type ContractAction = {
+    provider: string;
+    model: string;
+    endpoint: string;
+    models: string[];
+    fields_by_model: Record<string, Record<string, ContractField>>;
+};
+export type Contract = {
+    generated_by: string;
+    catalog_models: string[];
+    actions: Record<string, ContractAction>;
+    unresolved_actions: string[];
+};
+export type PricingConfig = {
+    markup_rate?: number;
+    provider_markup?: Record<string, number>;
+    endpoint_markup?: Record<string, number>;
+    endpoints?: Record<string, PricingEndpoint>;
+};
+export type PricingEndpoint = {
+    cost_unit_price_cents?: number;
+    cost_input_price_per_1m_cents?: number;
+    cost_output_price_per_1m_cents?: number;
+    cost_cache_read_price_per_1m_cents?: number;
+    cost_cache_write_5m_price_per_1m_cents?: number;
+    cost_cache_write_1h_price_per_1m_cents?: number;
+    cost_billing_config?: {
+        key?: string;
+        overrides?: Record<string, number>;
+    };
+};
+export type ModelInfo = {
+    service: string;
+    action: string;
+    route_action: string;
+    provider: string;
+    model_line: string;
+    model: string;
+    fields: Record<string, ContractField>;
+};
+export type RunApiTaskResponse = {
+    id?: string;
+    task_id?: string;
+    status?: string;
+    state?: string;
+    data?: unknown;
+    result?: unknown;
+    output?: unknown;
+    outputs?: unknown;
+    url?: string;
+    urls?: string[];
+    cost_cents?: number;
+    amount_cents?: number;
+    [key: string]: unknown;
+};
+export type SearchPromptsParams = {
+    modality?: string;
+    category?: string;
+    tags?: string[];
+    q?: string;
+    model?: string;
+    featured?: boolean;
+    page?: number;
+    per_page?: number;
+};
+export type RunApiPrompt = {
+    id: number;
+    title?: string | null;
+    prompt: string;
+    modality: string;
+    service?: string | null;
+    action?: string | null;
+    runapi_model?: string | null;
+    source_model?: string | null;
+    source?: string | null;
+    source_url?: string | null;
+    category?: string | null;
+    tags?: string[];
+    difficulty?: string | null;
+    engagement?: unknown;
+    params?: unknown;
+    preview_url?: string | null;
+    featured?: boolean;
+};
+export type RunApiPromptsResponse = {
+    prompts: RunApiPrompt[];
+    pagination: {
+        page: number;
+        per_page: number;
+        total: number;
+        pages: number;
+    };
+};
+export type PollingOptions = {
+    timeoutMs?: number;
+    intervalMs?: number;
+    onProgress?: (task: RunApiTaskResponse) => Promise<void> | void;
+};
+export type InputRule = {
+    when: Record<string, unknown>;
+    required: string[];
+    forbidden: string[];
+    description: string;
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@runapi.ai/mcp-core",
+  "version": "0.1.0",
+  "description": "Reusable core for building RunAPI MCP servers: client, contract/pricing/schema queries, input-rule engine, and a createModelServer factory.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "runapi",
+    "mcp",
+    "model-context-protocol",
+    "ai"
+  ],
+  "author": "RunAPI",
+  "license": "Apache-2.0",
+  "homepage": "https://runapi.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/runapi-ai/mcp-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/runapi-ai/mcp-core/issues"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.14"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}