@ai-sdk/gmicloud 0.0.0 → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1 @@
+# @ai-sdk/gmicloud

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2023 Vercel, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -1,3 +1,49 @@
-# @ai-sdk/gmicloud
+# AI SDK - GMI Cloud Provider
 
-AI SDK provider for GMI Cloud.
+The **GMI Cloud provider** for the [AI SDK](https://ai-sdk.dev/docs) contains language model support for [GMI Cloud](https://www.gmicloud.ai), offering GPU inference for open-weight models over an OpenAI-compatible API.
+
+> **Deploying to Vercel?** With Vercel's AI Gateway you can access GMI Cloud (and hundreds of models from other providers) — no additional packages, API keys, or extra cost. [Get started with AI Gateway](https://vercel.com/ai-gateway).
+
+## Setup
+
+The GMI Cloud provider is available in the `@ai-sdk/gmicloud` module. You can install it with
+
+```bash
+npm i @ai-sdk/gmicloud
+```
+
+## Provider Instance
+
+You can import the default provider instance `gmicloud` from `@ai-sdk/gmicloud`:
+
+```ts
+import { gmicloud } from '@ai-sdk/gmicloud';
+```
+
+The GMI Cloud API key is read from the `GMI_CLOUD_APIKEY` environment variable by default. For custom configuration, use `createGmicloud`:
+
+```ts
+import { createGmicloud } from '@ai-sdk/gmicloud';
+
+const gmicloud = createGmicloud({
+  apiKey: process.env.GMI_CLOUD_APIKEY ?? '',
+});
+```
+
+## Language Models
+
+```ts
+import { gmicloud } from '@ai-sdk/gmicloud';
+import { generateText } from 'ai';
+
+const { text } = await generateText({
+  model: gmicloud('deepseek-ai/DeepSeek-V4-Flash-0731'),
+  prompt: 'What is the capital of France?',
+});
+```
+
+GMI Cloud serves an evolving catalog of open-weight models over chat completions, so model ids are typed as `string`. Embedding and image models are not supported.
+
+## Error diagnostics
+
+GMI Cloud's edge reports a generic banner in `error.message` on rejections and nests the backend engine's diagnostic in `error.details`. This provider unwraps the nested diagnostic, so `AI_APICallError.message` carries the engine's reason (e.g. `The request is invalid: Invalid max_tokens value, the valid range of max_tokens is [1, 393216].`) instead of `Backend request failed with status 400`.

package/dist/index.d.mts

@@ -0,0 +1,58 @@
+import { ProviderV2, LanguageModelV2 } from '@ai-sdk/provider';
+import { FetchFunction } from '@ai-sdk/provider-utils';
+import { z } from 'zod/v4';
+
+type GmicloudChatModelId = 'deepseek-ai/DeepSeek-V4-Flash-0731' | 'Qwen/Qwen3.8-Max' | 'moonshotai/kimi-k3' | 'zai-org/GLM-5.2-FP8' | 'MiniMaxAI/MiniMax-M3' | (string & {});
+
+interface GmicloudProviderSettings {
+    /**
+     * GMI Cloud API key. Defaults to the `GMI_CLOUD_APIKEY` environment
+     * variable (matching GMI's own SDK package).
+     */
+    apiKey?: string;
+    /**
+     * Base URL for the API calls. Defaults to
+     * `https://api.gmi-serving.com/v1`.
+     */
+    baseURL?: string;
+    /**
+     * Custom headers to include in the requests.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Custom fetch implementation. You can use it as a middleware to intercept
+     * requests, or to provide a custom fetch implementation for e.g. testing.
+     */
+    fetch?: FetchFunction;
+}
+interface GmicloudProvider extends ProviderV2 {
+    /**
+     * Creates a GMI Cloud model for text generation.
+     */
+    (modelId: GmicloudChatModelId): LanguageModelV2;
+    /**
+     * Creates a GMI Cloud model for text generation.
+     */
+    languageModel(modelId: GmicloudChatModelId): LanguageModelV2;
+    /**
+     * Creates a GMI Cloud chat model for text generation.
+     */
+    chat(modelId: GmicloudChatModelId): LanguageModelV2;
+}
+declare function createGmicloud(options?: GmicloudProviderSettings): GmicloudProvider;
+declare const gmicloud: GmicloudProvider;
+
+declare const gmicloudErrorDataSchema: z.ZodObject<{
+    error: z.ZodObject<{
+        message: z.ZodString;
+        type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        param: z.ZodOptional<z.ZodNullable<z.ZodAny>>;
+        code: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        details: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type GmicloudErrorData = z.infer<typeof gmicloudErrorDataSchema>;
+
+declare const VERSION: string;
+
+export { type GmicloudErrorData, type GmicloudProvider, type GmicloudProviderSettings, VERSION, createGmicloud, gmicloud };

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+import { ProviderV2, LanguageModelV2 } from '@ai-sdk/provider';
+import { FetchFunction } from '@ai-sdk/provider-utils';
+import { z } from 'zod/v4';
+
+type GmicloudChatModelId = 'deepseek-ai/DeepSeek-V4-Flash-0731' | 'Qwen/Qwen3.8-Max' | 'moonshotai/kimi-k3' | 'zai-org/GLM-5.2-FP8' | 'MiniMaxAI/MiniMax-M3' | (string & {});
+
+interface GmicloudProviderSettings {
+    /**
+     * GMI Cloud API key. Defaults to the `GMI_CLOUD_APIKEY` environment
+     * variable (matching GMI's own SDK package).
+     */
+    apiKey?: string;
+    /**
+     * Base URL for the API calls. Defaults to
+     * `https://api.gmi-serving.com/v1`.
+     */
+    baseURL?: string;
+    /**
+     * Custom headers to include in the requests.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Custom fetch implementation. You can use it as a middleware to intercept
+     * requests, or to provide a custom fetch implementation for e.g. testing.
+     */
+    fetch?: FetchFunction;
+}
+interface GmicloudProvider extends ProviderV2 {
+    /**
+     * Creates a GMI Cloud model for text generation.
+     */
+    (modelId: GmicloudChatModelId): LanguageModelV2;
+    /**
+     * Creates a GMI Cloud model for text generation.
+     */
+    languageModel(modelId: GmicloudChatModelId): LanguageModelV2;
+    /**
+     * Creates a GMI Cloud chat model for text generation.
+     */
+    chat(modelId: GmicloudChatModelId): LanguageModelV2;
+}
+declare function createGmicloud(options?: GmicloudProviderSettings): GmicloudProvider;
+declare const gmicloud: GmicloudProvider;
+
+declare const gmicloudErrorDataSchema: z.ZodObject<{
+    error: z.ZodObject<{
+        message: z.ZodString;
+        type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        param: z.ZodOptional<z.ZodNullable<z.ZodAny>>;
+        code: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        details: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type GmicloudErrorData = z.infer<typeof gmicloudErrorDataSchema>;
+
+declare const VERSION: string;
+
+export { type GmicloudErrorData, type GmicloudProvider, type GmicloudProviderSettings, VERSION, createGmicloud, gmicloud };

package/dist/index.js

@@ -0,0 +1,121 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  VERSION: () => VERSION,
+  createGmicloud: () => createGmicloud,
+  gmicloud: () => gmicloud
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/gmicloud-provider.ts
+var import_provider = require("@ai-sdk/provider");
+var import_provider_utils = require("@ai-sdk/provider-utils");
+
+// src/gmicloud-chat-language-model.ts
+var import_openai_compatible = require("@ai-sdk/openai-compatible");
+var GmicloudChatLanguageModel = class extends import_openai_compatible.OpenAICompatibleChatLanguageModel {
+};
+
+// src/gmicloud-error.ts
+var import_v4 = require("zod/v4");
+var gmicloudErrorDataSchema = import_v4.z.object({
+  error: import_v4.z.object({
+    message: import_v4.z.string(),
+    type: import_v4.z.string().nullish(),
+    param: import_v4.z.any().nullish(),
+    code: import_v4.z.union([import_v4.z.string(), import_v4.z.number()]).nullish(),
+    details: import_v4.z.string().nullish()
+  })
+});
+function tryParseDetails(details) {
+  try {
+    return JSON.parse(details);
+  } catch (e) {
+    return void 0;
+  }
+}
+function unwrapDetailsMessage(details) {
+  var _a, _b;
+  if (details == null || details === "") {
+    return void 0;
+  }
+  const message = (_b = (_a = tryParseDetails(details)) == null ? void 0 : _a.error) == null ? void 0 : _b.message;
+  return typeof message === "string" && message.trim() !== "" ? message : void 0;
+}
+var gmicloudErrorStructure = {
+  errorSchema: gmicloudErrorDataSchema,
+  errorToMessage: (data) => {
+    var _a;
+    return (_a = unwrapDetailsMessage(data.error.details)) != null ? _a : data.error.message;
+  }
+};
+
+// src/version.ts
+var VERSION = true ? "1.0.0" : "0.0.0-test";
+
+// src/gmicloud-provider.ts
+function createGmicloud(options = {}) {
+  var _a;
+  const baseURL = (0, import_provider_utils.withoutTrailingSlash)(
+    (_a = options.baseURL) != null ? _a : "https://api.gmi-serving.com/v1"
+  );
+  const getHeaders = () => (0, import_provider_utils.withUserAgentSuffix)(
+    {
+      Authorization: `Bearer ${(0, import_provider_utils.loadApiKey)({
+        apiKey: options.apiKey,
+        environmentVariableName: "GMI_CLOUD_APIKEY",
+        description: "GMI Cloud API key"
+      })}`,
+      ...options.headers
+    },
+    `ai-sdk/gmicloud/${VERSION}`
+  );
+  const createLanguageModel = (modelId) => {
+    return new GmicloudChatLanguageModel(modelId, {
+      provider: `gmicloud.chat`,
+      url: ({ path }) => `${baseURL}${path}`,
+      headers: getHeaders,
+      fetch: options.fetch,
+      errorStructure: gmicloudErrorStructure,
+      includeUsage: true
+    });
+  };
+  const provider = (modelId) => createLanguageModel(modelId);
+  provider.specificationVersion = "v2";
+  provider.languageModel = createLanguageModel;
+  provider.chat = createLanguageModel;
+  provider.textEmbeddingModel = (modelId) => {
+    throw new import_provider.NoSuchModelError({ modelId, modelType: "textEmbeddingModel" });
+  };
+  provider.imageModel = (modelId) => {
+    throw new import_provider.NoSuchModelError({ modelId, modelType: "imageModel" });
+  };
+  return provider;
+}
+var gmicloud = createGmicloud();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VERSION,
+  createGmicloud,
+  gmicloud
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/gmicloud-provider.ts","../src/gmicloud-chat-language-model.ts","../src/gmicloud-error.ts","../src/version.ts"],"sourcesContent":["export { createGmicloud, gmicloud } from './gmicloud-provider';\nexport type {\n  GmicloudProvider,\n  GmicloudProviderSettings,\n} from './gmicloud-provider';\nexport type { GmicloudErrorData } from './gmicloud-error';\nexport { VERSION } from './version';\n","import {\n  NoSuchModelError,\n  type LanguageModelV2,\n  type ProviderV2,\n} from '@ai-sdk/provider';\nimport {\n  loadApiKey,\n  withoutTrailingSlash,\n  withUserAgentSuffix,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport { GmicloudChatLanguageModel } from './gmicloud-chat-language-model';\nimport type { GmicloudChatModelId } from './gmicloud-chat-options';\nimport { gmicloudErrorStructure } from './gmicloud-error';\nimport { VERSION } from './version';\n\nexport interface GmicloudProviderSettings {\n  /**\n   * GMI Cloud API key. Defaults to the `GMI_CLOUD_APIKEY` environment\n   * variable (matching GMI's own SDK package).\n   */\n  apiKey?: string;\n  /**\n   * Base URL for the API calls. Defaults to\n   * `https://api.gmi-serving.com/v1`.\n   */\n  baseURL?: string;\n  /**\n   * Custom headers to include in the requests.\n   */\n  headers?: Record<string, string>;\n  /**\n   * Custom fetch implementation. You can use it as a middleware to intercept\n   * requests, or to provide a custom fetch implementation for e.g. testing.\n   */\n  fetch?: FetchFunction;\n}\n\nexport interface GmicloudProvider extends ProviderV2 {\n  /**\n   * Creates a GMI Cloud model for text generation.\n   */\n  (modelId: GmicloudChatModelId): LanguageModelV2;\n\n  /**\n   * Creates a GMI Cloud model for text generation.\n   */\n  languageModel(modelId: GmicloudChatModelId): LanguageModelV2;\n\n  /**\n   * Creates a GMI Cloud chat model for text generation.\n   */\n  chat(modelId: GmicloudChatModelId): LanguageModelV2;\n}\n\nexport function createGmicloud(\n  options: GmicloudProviderSettings = {},\n): GmicloudProvider {\n  const baseURL = withoutTrailingSlash(\n    options.baseURL ?? 'https://api.gmi-serving.com/v1',\n  );\n  const getHeaders = () =>\n    withUserAgentSuffix(\n      {\n        Authorization: `Bearer ${loadApiKey({\n          apiKey: options.apiKey,\n          environmentVariableName: 'GMI_CLOUD_APIKEY',\n          description: 'GMI Cloud API key',\n        })}`,\n        ...options.headers,\n      },\n      `ai-sdk/gmicloud/${VERSION}`,\n    );\n\n  const createLanguageModel = (modelId: GmicloudChatModelId) => {\n    return new GmicloudChatLanguageModel(modelId, {\n      provider: `gmicloud.chat`,\n      url: ({ path }) => `${baseURL}${path}`,\n      headers: getHeaders,\n      fetch: options.fetch,\n      errorStructure: gmicloudErrorStructure,\n      includeUsage: true,\n    });\n  };\n\n  const provider = (modelId: GmicloudChatModelId) =>\n    createLanguageModel(modelId);\n\n  provider.specificationVersion = 'v2' as const;\n  provider.languageModel = createLanguageModel;\n  provider.chat = createLanguageModel;\n\n  provider.textEmbeddingModel = (modelId: string) => {\n    throw new NoSuchModelError({ modelId, modelType: 'textEmbeddingModel' });\n  };\n  provider.imageModel = (modelId: string) => {\n    throw new NoSuchModelError({ modelId, modelType: 'imageModel' });\n  };\n\n  return provider;\n}\n\nexport const gmicloud = createGmicloud();\n","import { OpenAICompatibleChatLanguageModel } from '@ai-sdk/openai-compatible';\n\n/**\n * GMI Cloud chat completions over the OpenAI-compatible protocol. The only\n * customization is the error structure (see ./gmicloud-error.ts): GMI's edge\n * nests the backend engine's diagnostic in `error.details`, which the default\n * OpenAI-compatible error handling drops.\n */\nexport class GmicloudChatLanguageModel extends OpenAICompatibleChatLanguageModel {}\n","import type { ProviderErrorStructure } from '@ai-sdk/openai-compatible';\nimport { z } from 'zod/v4';\n\nexport const gmicloudErrorDataSchema = z.object({\n  error: z.object({\n    message: z.string(),\n    type: z.string().nullish(),\n    param: z.any().nullish(),\n    code: z.union([z.string(), z.number()]).nullish(),\n    details: z.string().nullish(),\n  }),\n});\n\nexport type GmicloudErrorData = z.infer<typeof gmicloudErrorDataSchema>;\n\n// The parsed value is only read, never merged, so a guarded parse\n// (secureJsonParse) is not required here; the v5 provider-utils package does\n// not re-export it.\nfunction tryParseDetails(details: string): unknown {\n  try {\n    return JSON.parse(details);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction unwrapDetailsMessage(details: string | null | undefined) {\n  if (details == null || details === '') {\n    return undefined;\n  }\n  const message = (\n    tryParseDetails(details) as { error?: { message?: unknown } } | undefined\n  )?.error?.message;\n  return typeof message === 'string' && message.trim() !== ''\n    ? message\n    : undefined;\n}\n\nexport const gmicloudErrorStructure: ProviderErrorStructure<GmicloudErrorData> =\n  {\n    errorSchema: gmicloudErrorDataSchema,\n    errorToMessage: data =>\n      unwrapDetailsMessage(data.error.details) ?? data.error.message,\n  };\n","// Version string of this package injected at build time.\ndeclare const __PACKAGE_VERSION__: string | undefined;\nexport const VERSION: string =\n  typeof __PACKAGE_VERSION__ !== 'undefined'\n    ? __PACKAGE_VERSION__\n    : '0.0.0-test';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,sBAIO;AACP,4BAKO;;;ACVP,+BAAkD;AAQ3C,IAAM,4BAAN,cAAwC,2DAAkC;AAAC;;;ACPlF,gBAAkB;AAEX,IAAM,0BAA0B,YAAE,OAAO;AAAA,EAC9C,OAAO,YAAE,OAAO;AAAA,IACd,SAAS,YAAE,OAAO;AAAA,IAClB,MAAM,YAAE,OAAO,EAAE,QAAQ;AAAA,IACzB,OAAO,YAAE,IAAI,EAAE,QAAQ;AAAA,IACvB,MAAM,YAAE,MAAM,CAAC,YAAE,OAAO,GAAG,YAAE,OAAO,CAAC,CAAC,EAAE,QAAQ;AAAA,IAChD,SAAS,YAAE,OAAO,EAAE,QAAQ;AAAA,EAC9B,CAAC;AACH,CAAC;AAOD,SAAS,gBAAgB,SAA0B;AACjD,MAAI;AACF,WAAO,KAAK,MAAM,OAAO;AAAA,EAC3B,SAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,qBAAqB,SAAoC;AA1BlE;AA2BE,MAAI,WAAW,QAAQ,YAAY,IAAI;AACrC,WAAO;AAAA,EACT;AACA,QAAM,WACJ,2BAAgB,OAAO,MAAvB,mBACC,UADD,mBACQ;AACV,SAAO,OAAO,YAAY,YAAY,QAAQ,KAAK,MAAM,KACrD,UACA;AACN;AAEO,IAAM,yBACX;AAAA,EACE,aAAa;AAAA,EACb,gBAAgB,UAAK;AAzCzB;AA0CM,sCAAqB,KAAK,MAAM,OAAO,MAAvC,YAA4C,KAAK,MAAM;AAAA;AAC3D;;;ACzCK,IAAM,UACX,OACI,UACA;;;AHkDC,SAAS,eACd,UAAoC,CAAC,GACnB;AAzDpB;AA0DE,QAAM,cAAU;AAAA,KACd,aAAQ,YAAR,YAAmB;AAAA,EACrB;AACA,QAAM,aAAa,UACjB;AAAA,IACE;AAAA,MACE,eAAe,cAAU,kCAAW;AAAA,QAClC,QAAQ,QAAQ;AAAA,QAChB,yBAAyB;AAAA,QACzB,aAAa;AAAA,MACf,CAAC,CAAC;AAAA,MACF,GAAG,QAAQ;AAAA,IACb;AAAA,IACA,mBAAmB,OAAO;AAAA,EAC5B;AAEF,QAAM,sBAAsB,CAAC,YAAiC;AAC5D,WAAO,IAAI,0BAA0B,SAAS;AAAA,MAC5C,UAAU;AAAA,MACV,KAAK,CAAC,EAAE,KAAK,MAAM,GAAG,OAAO,GAAG,IAAI;AAAA,MACpC,SAAS;AAAA,MACT,OAAO,QAAQ;AAAA,MACf,gBAAgB;AAAA,MAChB,cAAc;AAAA,IAChB,CAAC;AAAA,EACH;AAEA,QAAM,WAAW,CAAC,YAChB,oBAAoB,OAAO;AAE7B,WAAS,uBAAuB;AAChC,WAAS,gBAAgB;AACzB,WAAS,OAAO;AAEhB,WAAS,qBAAqB,CAAC,YAAoB;AACjD,UAAM,IAAI,iCAAiB,EAAE,SAAS,WAAW,qBAAqB,CAAC;AAAA,EACzE;AACA,WAAS,aAAa,CAAC,YAAoB;AACzC,UAAM,IAAI,iCAAiB,EAAE,SAAS,WAAW,aAAa,CAAC;AAAA,EACjE;AAEA,SAAO;AACT;AAEO,IAAM,WAAW,eAAe;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,98 @@
+// src/gmicloud-provider.ts
+import {
+  NoSuchModelError
+} from "@ai-sdk/provider";
+import {
+  loadApiKey,
+  withoutTrailingSlash,
+  withUserAgentSuffix
+} from "@ai-sdk/provider-utils";
+
+// src/gmicloud-chat-language-model.ts
+import { OpenAICompatibleChatLanguageModel } from "@ai-sdk/openai-compatible";
+var GmicloudChatLanguageModel = class extends OpenAICompatibleChatLanguageModel {
+};
+
+// src/gmicloud-error.ts
+import { z } from "zod/v4";
+var gmicloudErrorDataSchema = z.object({
+  error: z.object({
+    message: z.string(),
+    type: z.string().nullish(),
+    param: z.any().nullish(),
+    code: z.union([z.string(), z.number()]).nullish(),
+    details: z.string().nullish()
+  })
+});
+function tryParseDetails(details) {
+  try {
+    return JSON.parse(details);
+  } catch (e) {
+    return void 0;
+  }
+}
+function unwrapDetailsMessage(details) {
+  var _a, _b;
+  if (details == null || details === "") {
+    return void 0;
+  }
+  const message = (_b = (_a = tryParseDetails(details)) == null ? void 0 : _a.error) == null ? void 0 : _b.message;
+  return typeof message === "string" && message.trim() !== "" ? message : void 0;
+}
+var gmicloudErrorStructure = {
+  errorSchema: gmicloudErrorDataSchema,
+  errorToMessage: (data) => {
+    var _a;
+    return (_a = unwrapDetailsMessage(data.error.details)) != null ? _a : data.error.message;
+  }
+};
+
+// src/version.ts
+var VERSION = true ? "1.0.0" : "0.0.0-test";
+
+// src/gmicloud-provider.ts
+function createGmicloud(options = {}) {
+  var _a;
+  const baseURL = withoutTrailingSlash(
+    (_a = options.baseURL) != null ? _a : "https://api.gmi-serving.com/v1"
+  );
+  const getHeaders = () => withUserAgentSuffix(
+    {
+      Authorization: `Bearer ${loadApiKey({
+        apiKey: options.apiKey,
+        environmentVariableName: "GMI_CLOUD_APIKEY",
+        description: "GMI Cloud API key"
+      })}`,
+      ...options.headers
+    },
+    `ai-sdk/gmicloud/${VERSION}`
+  );
+  const createLanguageModel = (modelId) => {
+    return new GmicloudChatLanguageModel(modelId, {
+      provider: `gmicloud.chat`,
+      url: ({ path }) => `${baseURL}${path}`,
+      headers: getHeaders,
+      fetch: options.fetch,
+      errorStructure: gmicloudErrorStructure,
+      includeUsage: true
+    });
+  };
+  const provider = (modelId) => createLanguageModel(modelId);
+  provider.specificationVersion = "v2";
+  provider.languageModel = createLanguageModel;
+  provider.chat = createLanguageModel;
+  provider.textEmbeddingModel = (modelId) => {
+    throw new NoSuchModelError({ modelId, modelType: "textEmbeddingModel" });
+  };
+  provider.imageModel = (modelId) => {
+    throw new NoSuchModelError({ modelId, modelType: "imageModel" });
+  };
+  return provider;
+}
+var gmicloud = createGmicloud();
+export {
+  VERSION,
+  createGmicloud,
+  gmicloud
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/gmicloud-provider.ts","../src/gmicloud-chat-language-model.ts","../src/gmicloud-error.ts","../src/version.ts"],"sourcesContent":["import {\n  NoSuchModelError,\n  type LanguageModelV2,\n  type ProviderV2,\n} from '@ai-sdk/provider';\nimport {\n  loadApiKey,\n  withoutTrailingSlash,\n  withUserAgentSuffix,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport { GmicloudChatLanguageModel } from './gmicloud-chat-language-model';\nimport type { GmicloudChatModelId } from './gmicloud-chat-options';\nimport { gmicloudErrorStructure } from './gmicloud-error';\nimport { VERSION } from './version';\n\nexport interface GmicloudProviderSettings {\n  /**\n   * GMI Cloud API key. Defaults to the `GMI_CLOUD_APIKEY` environment\n   * variable (matching GMI's own SDK package).\n   */\n  apiKey?: string;\n  /**\n   * Base URL for the API calls. Defaults to\n   * `https://api.gmi-serving.com/v1`.\n   */\n  baseURL?: string;\n  /**\n   * Custom headers to include in the requests.\n   */\n  headers?: Record<string, string>;\n  /**\n   * Custom fetch implementation. You can use it as a middleware to intercept\n   * requests, or to provide a custom fetch implementation for e.g. testing.\n   */\n  fetch?: FetchFunction;\n}\n\nexport interface GmicloudProvider extends ProviderV2 {\n  /**\n   * Creates a GMI Cloud model for text generation.\n   */\n  (modelId: GmicloudChatModelId): LanguageModelV2;\n\n  /**\n   * Creates a GMI Cloud model for text generation.\n   */\n  languageModel(modelId: GmicloudChatModelId): LanguageModelV2;\n\n  /**\n   * Creates a GMI Cloud chat model for text generation.\n   */\n  chat(modelId: GmicloudChatModelId): LanguageModelV2;\n}\n\nexport function createGmicloud(\n  options: GmicloudProviderSettings = {},\n): GmicloudProvider {\n  const baseURL = withoutTrailingSlash(\n    options.baseURL ?? 'https://api.gmi-serving.com/v1',\n  );\n  const getHeaders = () =>\n    withUserAgentSuffix(\n      {\n        Authorization: `Bearer ${loadApiKey({\n          apiKey: options.apiKey,\n          environmentVariableName: 'GMI_CLOUD_APIKEY',\n          description: 'GMI Cloud API key',\n        })}`,\n        ...options.headers,\n      },\n      `ai-sdk/gmicloud/${VERSION}`,\n    );\n\n  const createLanguageModel = (modelId: GmicloudChatModelId) => {\n    return new GmicloudChatLanguageModel(modelId, {\n      provider: `gmicloud.chat`,\n      url: ({ path }) => `${baseURL}${path}`,\n      headers: getHeaders,\n      fetch: options.fetch,\n      errorStructure: gmicloudErrorStructure,\n      includeUsage: true,\n    });\n  };\n\n  const provider = (modelId: GmicloudChatModelId) =>\n    createLanguageModel(modelId);\n\n  provider.specificationVersion = 'v2' as const;\n  provider.languageModel = createLanguageModel;\n  provider.chat = createLanguageModel;\n\n  provider.textEmbeddingModel = (modelId: string) => {\n    throw new NoSuchModelError({ modelId, modelType: 'textEmbeddingModel' });\n  };\n  provider.imageModel = (modelId: string) => {\n    throw new NoSuchModelError({ modelId, modelType: 'imageModel' });\n  };\n\n  return provider;\n}\n\nexport const gmicloud = createGmicloud();\n","import { OpenAICompatibleChatLanguageModel } from '@ai-sdk/openai-compatible';\n\n/**\n * GMI Cloud chat completions over the OpenAI-compatible protocol. The only\n * customization is the error structure (see ./gmicloud-error.ts): GMI's edge\n * nests the backend engine's diagnostic in `error.details`, which the default\n * OpenAI-compatible error handling drops.\n */\nexport class GmicloudChatLanguageModel extends OpenAICompatibleChatLanguageModel {}\n","import type { ProviderErrorStructure } from '@ai-sdk/openai-compatible';\nimport { z } from 'zod/v4';\n\nexport const gmicloudErrorDataSchema = z.object({\n  error: z.object({\n    message: z.string(),\n    type: z.string().nullish(),\n    param: z.any().nullish(),\n    code: z.union([z.string(), z.number()]).nullish(),\n    details: z.string().nullish(),\n  }),\n});\n\nexport type GmicloudErrorData = z.infer<typeof gmicloudErrorDataSchema>;\n\n// The parsed value is only read, never merged, so a guarded parse\n// (secureJsonParse) is not required here; the v5 provider-utils package does\n// not re-export it.\nfunction tryParseDetails(details: string): unknown {\n  try {\n    return JSON.parse(details);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction unwrapDetailsMessage(details: string | null | undefined) {\n  if (details == null || details === '') {\n    return undefined;\n  }\n  const message = (\n    tryParseDetails(details) as { error?: { message?: unknown } } | undefined\n  )?.error?.message;\n  return typeof message === 'string' && message.trim() !== ''\n    ? message\n    : undefined;\n}\n\nexport const gmicloudErrorStructure: ProviderErrorStructure<GmicloudErrorData> =\n  {\n    errorSchema: gmicloudErrorDataSchema,\n    errorToMessage: data =>\n      unwrapDetailsMessage(data.error.details) ?? data.error.message,\n  };\n","// Version string of this package injected at build time.\ndeclare const __PACKAGE_VERSION__: string | undefined;\nexport const VERSION: string =\n  typeof __PACKAGE_VERSION__ !== 'undefined'\n    ? __PACKAGE_VERSION__\n    : '0.0.0-test';\n"],"mappings":";AAAA;AAAA,EACE;AAAA,OAGK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;;;ACVP,SAAS,yCAAyC;AAQ3C,IAAM,4BAAN,cAAwC,kCAAkC;AAAC;;;ACPlF,SAAS,SAAS;AAEX,IAAM,0BAA0B,EAAE,OAAO;AAAA,EAC9C,OAAO,EAAE,OAAO;AAAA,IACd,SAAS,EAAE,OAAO;AAAA,IAClB,MAAM,EAAE,OAAO,EAAE,QAAQ;AAAA,IACzB,OAAO,EAAE,IAAI,EAAE,QAAQ;AAAA,IACvB,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,QAAQ;AAAA,IAChD,SAAS,EAAE,OAAO,EAAE,QAAQ;AAAA,EAC9B,CAAC;AACH,CAAC;AAOD,SAAS,gBAAgB,SAA0B;AACjD,MAAI;AACF,WAAO,KAAK,MAAM,OAAO;AAAA,EAC3B,SAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,qBAAqB,SAAoC;AA1BlE;AA2BE,MAAI,WAAW,QAAQ,YAAY,IAAI;AACrC,WAAO;AAAA,EACT;AACA,QAAM,WACJ,2BAAgB,OAAO,MAAvB,mBACC,UADD,mBACQ;AACV,SAAO,OAAO,YAAY,YAAY,QAAQ,KAAK,MAAM,KACrD,UACA;AACN;AAEO,IAAM,yBACX;AAAA,EACE,aAAa;AAAA,EACb,gBAAgB,UAAK;AAzCzB;AA0CM,sCAAqB,KAAK,MAAM,OAAO,MAAvC,YAA4C,KAAK,MAAM;AAAA;AAC3D;;;ACzCK,IAAM,UACX,OACI,UACA;;;AHkDC,SAAS,eACd,UAAoC,CAAC,GACnB;AAzDpB;AA0DE,QAAM,UAAU;AAAA,KACd,aAAQ,YAAR,YAAmB;AAAA,EACrB;AACA,QAAM,aAAa,MACjB;AAAA,IACE;AAAA,MACE,eAAe,UAAU,WAAW;AAAA,QAClC,QAAQ,QAAQ;AAAA,QAChB,yBAAyB;AAAA,QACzB,aAAa;AAAA,MACf,CAAC,CAAC;AAAA,MACF,GAAG,QAAQ;AAAA,IACb;AAAA,IACA,mBAAmB,OAAO;AAAA,EAC5B;AAEF,QAAM,sBAAsB,CAAC,YAAiC;AAC5D,WAAO,IAAI,0BAA0B,SAAS;AAAA,MAC5C,UAAU;AAAA,MACV,KAAK,CAAC,EAAE,KAAK,MAAM,GAAG,OAAO,GAAG,IAAI;AAAA,MACpC,SAAS;AAAA,MACT,OAAO,QAAQ;AAAA,MACf,gBAAgB;AAAA,MAChB,cAAc;AAAA,IAChB,CAAC;AAAA,EACH;AAEA,QAAM,WAAW,CAAC,YAChB,oBAAoB,OAAO;AAE7B,WAAS,uBAAuB;AAChC,WAAS,gBAAgB;AACzB,WAAS,OAAO;AAEhB,WAAS,qBAAqB,CAAC,YAAoB;AACjD,UAAM,IAAI,iBAAiB,EAAE,SAAS,WAAW,qBAAqB,CAAC;AAAA,EACzE;AACA,WAAS,aAAa,CAAC,YAAoB;AACzC,UAAM,IAAI,iBAAiB,EAAE,SAAS,WAAW,aAAa,CAAC;AAAA,EACjE;AAEA,SAAO;AACT;AAEO,IAAM,WAAW,eAAe;","names":[]}

package/docs/100-gmicloud.mdx

@@ -0,0 +1,72 @@
+---
+title: GMI Cloud
+description: Learn how to use GMI Cloud's models with the AI SDK.
+---
+
+# GMI Cloud Provider
+
+The [GMI Cloud](https://www.gmicloud.ai) provider offers access to open-weight language models through GMI Cloud's GPU inference platform, over an OpenAI-compatible API.
+
+API keys can be obtained from the [GMI Cloud console](https://console.gmicloud.ai).
+
+## Setup
+
+The GMI Cloud provider is available via the `@ai-sdk/gmicloud` module. You can install it with:
+
+<InstallPackages packages="@ai-sdk/gmicloud" />
+
+## Provider Instance
+
+You can import the default provider instance `gmicloud` from `@ai-sdk/gmicloud`:
+
+```ts
+import { gmicloud } from '@ai-sdk/gmicloud';
+```
+
+For custom configuration, you can import `createGmicloud` and create a provider instance with your settings:
+
+```ts
+import { createGmicloud } from '@ai-sdk/gmicloud';
+
+const gmicloud = createGmicloud({
+  apiKey: process.env.GMI_CLOUD_APIKEY ?? '',
+});
+```
+
+You can use the following optional settings to customize the GMI Cloud provider instance:
+
+- **baseURL** _string_
+
+  Use a different URL prefix for API calls.
+  The default prefix is `https://api.gmi-serving.com/v1`.
+
+- **apiKey** _string_
+
+  API key that is being sent using the `Authorization` header. It defaults to
+  the `GMI_CLOUD_APIKEY` environment variable.
+
+- **headers** _Record&lt;string,string&gt;_
+
+  Custom headers to include in the requests.
+
+- **fetch** _FetchFunction_
+
+  Custom fetch implementation.
+
+## Language Models
+
+```ts
+import { gmicloud } from '@ai-sdk/gmicloud';
+import { generateText } from 'ai';
+
+const { text } = await generateText({
+  model: gmicloud('deepseek-ai/DeepSeek-V4-Flash-0731'),
+  prompt: 'What is the capital of France?',
+});
+```
+
+GMI Cloud serves an evolving catalog of open-weight models, so model ids are typed as `string`. Embedding and image models are not supported.
+
+## Error diagnostics
+
+GMI Cloud's edge reports a generic banner in `error.message` on rejections and nests the backend engine's diagnostic in `error.details`. This provider unwraps the nested diagnostic, so `AI_APICallError.message` carries the engine's reason (e.g. `The request is invalid: Invalid max_tokens value, the valid range of max_tokens is [1, 393216].`) instead of `Backend request failed with status 400`.

package/package.json

@@ -1,18 +1,78 @@
 {
   "name": "@ai-sdk/gmicloud",
-  "version": "0.0.0",
-  "description": "AI SDK provider for GMI Cloud",
+  "version": "1.0.0",
+  "type": "commonjs",
   "license": "Apache-2.0",
-  "type": "module",
-  "main": "./index.js",
-  "exports": {
-    ".": "./index.js"
-  },
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
   "files": [
-    "index.js",
+    "dist/**/*",
+    "docs/**/*",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test-d.ts",
+    "!src/**/__snapshots__",
+    "!src/**/__fixtures__",
+    "CHANGELOG.md",
     "README.md"
   ],
+  "directories": {
+    "doc": "./docs"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@ai-sdk/openai-compatible": "1.0.48",
+    "@ai-sdk/provider": "2.0.3",
+    "@ai-sdk/provider-utils": "3.0.32"
+  },
+  "devDependencies": {
+    "@types/node": "20.17.24",
+    "tsup": "^8",
+    "typescript": "5.8.3",
+    "zod": "3.25.76",
+    "@vercel/ai-tsconfig": "0.0.0"
+  },
+  "peerDependencies": {
+    "zod": "^3.25.76 || ^4.1.8"
+  },
+  "engines": {
+    "node": ">=18"
+  },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
+  },
+  "homepage": "https://ai-sdk.dev/docs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vercel/ai",
+    "directory": "packages/gmicloud"
+  },
+  "bugs": {
+    "url": "https://github.com/vercel/ai/issues"
+  },
+  "keywords": [
+    "ai"
+  ],
+  "description": "The **GMI Cloud provider** for the [AI SDK](https://ai-sdk.dev/docs) contains language model support for [GMI Cloud](https://www.gmicloud.ai), offering GPU inference for open-weight models over an OpenAI-compatible API.",
+  "scripts": {
+    "build": "pnpm clean && tsup --tsconfig tsconfig.build.json",
+    "build:watch": "pnpm clean && tsup --watch",
+    "clean": "del-cli dist docs *.tsbuildinfo",
+    "type-check": "tsc --build",
+    "test": "pnpm test:node && pnpm test:edge",
+    "test:update": "pnpm test:node -u",
+    "test:watch": "vitest --config vitest.node.config.js",
+    "test:edge": "vitest --config vitest.edge.config.js --run",
+    "test:node": "vitest --config vitest.node.config.js --run"
   }
-}
+}

package/src/gmicloud-chat-language-model-options.ts

@@ -0,0 +1,3 @@
+export type { GmicloudChatModelId } from './gmicloud-chat-options';
+
+export type GmicloudLanguageModelChatOptions = Record<string, never>;

package/src/gmicloud-chat-language-model.ts

@@ -0,0 +1,9 @@
+import { OpenAICompatibleChatLanguageModel } from '@ai-sdk/openai-compatible';
+
+/**
+ * GMI Cloud chat completions over the OpenAI-compatible protocol. The only
+ * customization is the error structure (see ./gmicloud-error.ts): GMI's edge
+ * nests the backend engine's diagnostic in `error.details`, which the default
+ * OpenAI-compatible error handling drops.
+ */
+export class GmicloudChatLanguageModel extends OpenAICompatibleChatLanguageModel {}

package/src/gmicloud-chat-options.ts

@@ -0,0 +1,8 @@
+// Catalog: GET https://api.gmi-serving.com/v1/models
+export type GmicloudChatModelId =
+  | 'deepseek-ai/DeepSeek-V4-Flash-0731'
+  | 'Qwen/Qwen3.8-Max'
+  | 'moonshotai/kimi-k3'
+  | 'zai-org/GLM-5.2-FP8'
+  | 'MiniMaxAI/MiniMax-M3'
+  | (string & {});

package/src/gmicloud-error.ts

@@ -0,0 +1,44 @@
+import type { ProviderErrorStructure } from '@ai-sdk/openai-compatible';
+import { z } from 'zod/v4';
+
+export const gmicloudErrorDataSchema = z.object({
+  error: z.object({
+    message: z.string(),
+    type: z.string().nullish(),
+    param: z.any().nullish(),
+    code: z.union([z.string(), z.number()]).nullish(),
+    details: z.string().nullish(),
+  }),
+});
+
+export type GmicloudErrorData = z.infer<typeof gmicloudErrorDataSchema>;
+
+// The parsed value is only read, never merged, so a guarded parse
+// (secureJsonParse) is not required here; the v5 provider-utils package does
+// not re-export it.
+function tryParseDetails(details: string): unknown {
+  try {
+    return JSON.parse(details);
+  } catch {
+    return undefined;
+  }
+}
+
+function unwrapDetailsMessage(details: string | null | undefined) {
+  if (details == null || details === '') {
+    return undefined;
+  }
+  const message = (
+    tryParseDetails(details) as { error?: { message?: unknown } } | undefined
+  )?.error?.message;
+  return typeof message === 'string' && message.trim() !== ''
+    ? message
+    : undefined;
+}
+
+export const gmicloudErrorStructure: ProviderErrorStructure<GmicloudErrorData> =
+  {
+    errorSchema: gmicloudErrorDataSchema,
+    errorToMessage: data =>
+      unwrapDetailsMessage(data.error.details) ?? data.error.message,
+  };

package/src/gmicloud-provider.ts

@@ -0,0 +1,103 @@
+import {
+  NoSuchModelError,
+  type LanguageModelV2,
+  type ProviderV2,
+} from '@ai-sdk/provider';
+import {
+  loadApiKey,
+  withoutTrailingSlash,
+  withUserAgentSuffix,
+  type FetchFunction,
+} from '@ai-sdk/provider-utils';
+import { GmicloudChatLanguageModel } from './gmicloud-chat-language-model';
+import type { GmicloudChatModelId } from './gmicloud-chat-options';
+import { gmicloudErrorStructure } from './gmicloud-error';
+import { VERSION } from './version';
+
+export interface GmicloudProviderSettings {
+  /**
+   * GMI Cloud API key. Defaults to the `GMI_CLOUD_APIKEY` environment
+   * variable (matching GMI's own SDK package).
+   */
+  apiKey?: string;
+  /**
+   * Base URL for the API calls. Defaults to
+   * `https://api.gmi-serving.com/v1`.
+   */
+  baseURL?: string;
+  /**
+   * Custom headers to include in the requests.
+   */
+  headers?: Record<string, string>;
+  /**
+   * Custom fetch implementation. You can use it as a middleware to intercept
+   * requests, or to provide a custom fetch implementation for e.g. testing.
+   */
+  fetch?: FetchFunction;
+}
+
+export interface GmicloudProvider extends ProviderV2 {
+  /**
+   * Creates a GMI Cloud model for text generation.
+   */
+  (modelId: GmicloudChatModelId): LanguageModelV2;
+
+  /**
+   * Creates a GMI Cloud model for text generation.
+   */
+  languageModel(modelId: GmicloudChatModelId): LanguageModelV2;
+
+  /**
+   * Creates a GMI Cloud chat model for text generation.
+   */
+  chat(modelId: GmicloudChatModelId): LanguageModelV2;
+}
+
+export function createGmicloud(
+  options: GmicloudProviderSettings = {},
+): GmicloudProvider {
+  const baseURL = withoutTrailingSlash(
+    options.baseURL ?? 'https://api.gmi-serving.com/v1',
+  );
+  const getHeaders = () =>
+    withUserAgentSuffix(
+      {
+        Authorization: `Bearer ${loadApiKey({
+          apiKey: options.apiKey,
+          environmentVariableName: 'GMI_CLOUD_APIKEY',
+          description: 'GMI Cloud API key',
+        })}`,
+        ...options.headers,
+      },
+      `ai-sdk/gmicloud/${VERSION}`,
+    );
+
+  const createLanguageModel = (modelId: GmicloudChatModelId) => {
+    return new GmicloudChatLanguageModel(modelId, {
+      provider: `gmicloud.chat`,
+      url: ({ path }) => `${baseURL}${path}`,
+      headers: getHeaders,
+      fetch: options.fetch,
+      errorStructure: gmicloudErrorStructure,
+      includeUsage: true,
+    });
+  };
+
+  const provider = (modelId: GmicloudChatModelId) =>
+    createLanguageModel(modelId);
+
+  provider.specificationVersion = 'v2' as const;
+  provider.languageModel = createLanguageModel;
+  provider.chat = createLanguageModel;
+
+  provider.textEmbeddingModel = (modelId: string) => {
+    throw new NoSuchModelError({ modelId, modelType: 'textEmbeddingModel' });
+  };
+  provider.imageModel = (modelId: string) => {
+    throw new NoSuchModelError({ modelId, modelType: 'imageModel' });
+  };
+
+  return provider;
+}
+
+export const gmicloud = createGmicloud();

package/src/index.ts

@@ -0,0 +1,7 @@
+export { createGmicloud, gmicloud } from './gmicloud-provider';
+export type {
+  GmicloudProvider,
+  GmicloudProviderSettings,
+} from './gmicloud-provider';
+export type { GmicloudErrorData } from './gmicloud-error';
+export { VERSION } from './version';

package/src/version.ts

@@ -0,0 +1,6 @@
+// Version string of this package injected at build time.
+declare const __PACKAGE_VERSION__: string | undefined;
+export const VERSION: string =
+  typeof __PACKAGE_VERSION__ !== 'undefined'
+    ? __PACKAGE_VERSION__
+    : '0.0.0-test';

package/index.js

@@ -1 +0,0 @@
-export {};