@ai-sdk/gmicloud 0.0.0 → 3.0.1

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# @ai-sdk/gmicloud
+
+## 3.0.1
+
+### Patch Changes
+
+- Updated dependencies [7fbfc6d]
+  - @ai-sdk/provider-utils@5.0.27
+  - @ai-sdk/openai-compatible@3.0.30
+
+## 3.0.0
+
+### Major Changes
+
+- 74556f7: feat(gmicloud): add GMI Cloud provider with OpenAI-compatible chat completions and unwrapped error diagnostics

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.ts

@@ -0,0 +1,62 @@
+import { ProviderV4, LanguageModelV4 } 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 ProviderV4 {
+    /**
+     * Creates a GMI Cloud model for text generation.
+     */
+    (modelId: GmicloudChatModelId): LanguageModelV4;
+    /**
+     * Creates a GMI Cloud model for text generation.
+     */
+    languageModel(modelId: GmicloudChatModelId): LanguageModelV4;
+    /**
+     * Creates a GMI Cloud chat model for text generation.
+     */
+    chat(modelId: GmicloudChatModelId): LanguageModelV4;
+    /**
+     * @deprecated Use `embeddingModel` instead.
+     */
+    textEmbeddingModel(modelId: string): never;
+}
+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,113 @@
+// 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";
+import {
+  serializeModelOptions,
+  WORKFLOW_DESERIALIZE,
+  WORKFLOW_SERIALIZE
+} from "@ai-sdk/provider-utils";
+var GmicloudChatLanguageModel = class _GmicloudChatLanguageModel extends OpenAICompatibleChatLanguageModel {
+  static [WORKFLOW_SERIALIZE](model) {
+    return serializeModelOptions({
+      modelId: model.modelId,
+      config: model.config
+    });
+  }
+  static [WORKFLOW_DESERIALIZE](options) {
+    return new _GmicloudChatLanguageModel(options.modelId, options.config);
+  }
+};
+
+// src/gmicloud-error.ts
+import { secureJsonParse } from "@ai-sdk/provider-utils";
+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 unwrapDetailsMessage(details) {
+  var _a;
+  if (details == null || details === "") {
+    return void 0;
+  }
+  let parsed;
+  try {
+    parsed = secureJsonParse(details);
+  } catch (e) {
+    return void 0;
+  }
+  const message = (_a = parsed == null ? void 0 : parsed.error) == null ? void 0 : _a.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 ? "3.0.1" : "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 = "v4";
+  provider.languageModel = createLanguageModel;
+  provider.chat = createLanguageModel;
+  provider.embeddingModel = (modelId) => {
+    throw new NoSuchModelError({ modelId, modelType: "embeddingModel" });
+  };
+  provider.textEmbeddingModel = provider.embeddingModel;
+  provider.imageModel = (modelId) => {
+    throw new NoSuchModelError({ modelId, modelType: "imageModel" });
+  };
+  return provider;
+}
+var gmicloud = createGmicloud();
+export {
+  VERSION,
+  createGmicloud,
+  gmicloud
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.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 LanguageModelV4,\n  type ProviderV4,\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 ProviderV4 {\n  /**\n   * Creates a GMI Cloud model for text generation.\n   */\n  (modelId: GmicloudChatModelId): LanguageModelV4;\n\n  /**\n   * Creates a GMI Cloud model for text generation.\n   */\n  languageModel(modelId: GmicloudChatModelId): LanguageModelV4;\n\n  /**\n   * Creates a GMI Cloud chat model for text generation.\n   */\n  chat(modelId: GmicloudChatModelId): LanguageModelV4;\n\n  /**\n   * @deprecated Use `embeddingModel` instead.\n   */\n  textEmbeddingModel(modelId: string): never;\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 = 'v4' as const;\n  provider.languageModel = createLanguageModel;\n  provider.chat = createLanguageModel;\n\n  provider.embeddingModel = (modelId: string) => {\n    throw new NoSuchModelError({ modelId, modelType: 'embeddingModel' });\n  };\n  provider.textEmbeddingModel = provider.embeddingModel;\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';\nimport type { LanguageModelV4 } from '@ai-sdk/provider';\nimport {\n  serializeModelOptions,\n  WORKFLOW_DESERIALIZE,\n  WORKFLOW_SERIALIZE,\n} from '@ai-sdk/provider-utils';\nimport type { GmicloudChatModelId } from './gmicloud-chat-language-model-options';\n\ntype GmicloudChatConfig = ConstructorParameters<\n  typeof OpenAICompatibleChatLanguageModel\n>[1];\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\n  extends OpenAICompatibleChatLanguageModel\n  implements LanguageModelV4\n{\n  static [WORKFLOW_SERIALIZE](model: GmicloudChatLanguageModel) {\n    return serializeModelOptions({\n      modelId: model.modelId,\n      config: model.config,\n    });\n  }\n\n  static [WORKFLOW_DESERIALIZE](options: {\n    modelId: GmicloudChatModelId;\n    config: GmicloudChatConfig;\n  }) {\n    return new GmicloudChatLanguageModel(options.modelId, options.config);\n  }\n}\n","import type { ProviderErrorStructure } from '@ai-sdk/openai-compatible';\nimport { secureJsonParse } from '@ai-sdk/provider-utils';\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\nfunction unwrapDetailsMessage(details: string | null | undefined) {\n  if (details == null || details === '') {\n    return undefined;\n  }\n  let parsed: unknown;\n  try {\n    parsed = secureJsonParse(details);\n  } catch {\n    return undefined;\n  }\n  const message = (parsed as { error?: { message?: unknown } })?.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;AAElD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAaA,IAAM,4BAAN,MAAM,mCACH,kCAEV;AAAA,EACE,QAAQ,kBAAkB,EAAE,OAAkC;AAC5D,WAAO,sBAAsB;AAAA,MAC3B,SAAS,MAAM;AAAA,MACf,QAAQ,MAAM;AAAA,IAChB,CAAC;AAAA,EACH;AAAA,EAEA,QAAQ,oBAAoB,EAAE,SAG3B;AACD,WAAO,IAAI,2BAA0B,QAAQ,SAAS,QAAQ,MAAM;AAAA,EACtE;AACF;;;ACnCA,SAAS,uBAAuB;AAChC,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;AAID,SAAS,qBAAqB,SAAoC;AAhBlE;AAiBE,MAAI,WAAW,QAAQ,YAAY,IAAI;AACrC,WAAO;AAAA,EACT;AACA,MAAI;AACJ,MAAI;AACF,aAAS,gBAAgB,OAAO;AAAA,EAClC,SAAQ;AACN,WAAO;AAAA,EACT;AACA,QAAM,WAAW,sCAA8C,UAA9C,mBAAqD;AACtE,SAAO,OAAO,YAAY,YAAY,QAAQ,KAAK,MAAM,KACrD,UACA;AACN;AAEO,IAAM,yBACX;AAAA,EACE,aAAa;AAAA,EACb,gBAAgB,UAAK;AAnCzB;AAoCM,sCAAqB,KAAK,MAAM,OAAO,MAAvC,YAA4C,KAAK,MAAM;AAAA;AAC3D;;;ACnCK,IAAM,UACX,OACI,UACA;;;AHuDC,SAAS,eACd,UAAoC,CAAC,GACnB;AA9DpB;AA+DE,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,iBAAiB,CAAC,YAAoB;AAC7C,UAAM,IAAI,iBAAiB,EAAE,SAAS,WAAW,iBAAiB,CAAC;AAAA,EACrE;AACA,WAAS,qBAAqB,SAAS;AACvC,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,77 @@
 {
   "name": "@ai-sdk/gmicloud",
-  "version": "0.0.0",
-  "description": "AI SDK provider for GMI Cloud",
-  "license": "Apache-2.0",
+  "version": "3.0.1",
   "type": "module",
-  "main": "./index.js",
-  "exports": {
-    ".": "./index.js"
-  },
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "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.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@ai-sdk/openai-compatible": "3.0.30",
+    "@ai-sdk/provider": "4.0.7",
+    "@ai-sdk/provider-utils": "5.0.27"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.19",
+    "tsup": "^8.5.1",
+    "typescript": "5.8.3",
+    "zod": "3.25.76",
+    "@vercel/ai-tsconfig": "0.0.0"
+  },
+  "peerDependencies": {
+    "zod": "^3.25.76 || ^4.1.8"
+  },
+  "engines": {
+    "node": ">=22"
+  },
   "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,37 @@
+import { OpenAICompatibleChatLanguageModel } from '@ai-sdk/openai-compatible';
+import type { LanguageModelV4 } from '@ai-sdk/provider';
+import {
+  serializeModelOptions,
+  WORKFLOW_DESERIALIZE,
+  WORKFLOW_SERIALIZE,
+} from '@ai-sdk/provider-utils';
+import type { GmicloudChatModelId } from './gmicloud-chat-language-model-options';
+
+type GmicloudChatConfig = ConstructorParameters<
+  typeof OpenAICompatibleChatLanguageModel
+>[1];
+
+/**
+ * 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
+  implements LanguageModelV4
+{
+  static [WORKFLOW_SERIALIZE](model: GmicloudChatLanguageModel) {
+    return serializeModelOptions({
+      modelId: model.modelId,
+      config: model.config,
+    });
+  }
+
+  static [WORKFLOW_DESERIALIZE](options: {
+    modelId: GmicloudChatModelId;
+    config: GmicloudChatConfig;
+  }) {
+    return new GmicloudChatLanguageModel(options.modelId, options.config);
+  }
+}

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,38 @@
+import type { ProviderErrorStructure } from '@ai-sdk/openai-compatible';
+import { secureJsonParse } from '@ai-sdk/provider-utils';
+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>;
+
+function unwrapDetailsMessage(details: string | null | undefined) {
+  if (details == null || details === '') {
+    return undefined;
+  }
+  let parsed: unknown;
+  try {
+    parsed = secureJsonParse(details);
+  } catch {
+    return undefined;
+  }
+  const message = (parsed as { error?: { message?: unknown } })?.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,109 @@
+import {
+  NoSuchModelError,
+  type LanguageModelV4,
+  type ProviderV4,
+} 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 ProviderV4 {
+  /**
+   * Creates a GMI Cloud model for text generation.
+   */
+  (modelId: GmicloudChatModelId): LanguageModelV4;
+
+  /**
+   * Creates a GMI Cloud model for text generation.
+   */
+  languageModel(modelId: GmicloudChatModelId): LanguageModelV4;
+
+  /**
+   * Creates a GMI Cloud chat model for text generation.
+   */
+  chat(modelId: GmicloudChatModelId): LanguageModelV4;
+
+  /**
+   * @deprecated Use `embeddingModel` instead.
+   */
+  textEmbeddingModel(modelId: string): never;
+}
+
+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 = 'v4' as const;
+  provider.languageModel = createLanguageModel;
+  provider.chat = createLanguageModel;
+
+  provider.embeddingModel = (modelId: string) => {
+    throw new NoSuchModelError({ modelId, modelType: 'embeddingModel' });
+  };
+  provider.textEmbeddingModel = provider.embeddingModel;
+  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 {};