@ai-sdk/gmicloud 3.0.55 → 3.0.57

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @ai-sdk/gmicloud
 
+## 3.0.57
+
+### Patch Changes
+
+- 2838776: Refactor GMI Cloud model ID logic into a model catalog that declares capabilities and provider options, and generate provider capability documentation from it. Request behavior is unchanged.
+- Updated dependencies [b63c06a]
+- Updated dependencies [646a7e3]
+  - @ai-sdk/openai-compatible@3.0.86
+
+## 3.0.56
+
+### Patch Changes
+
+- Updated dependencies [36802d4]
+- Updated dependencies [e0143b0]
+- Updated dependencies [934100c]
+- Updated dependencies [add01ab]
+- Updated dependencies [5f19ea5]
+- Updated dependencies [892af4d]
+- Updated dependencies [89aff56]
+- Updated dependencies [41465fd]
+- Updated dependencies [9754014]
+- Updated dependencies [4bb73b0]
+- Updated dependencies [2e44144]
+  - @ai-sdk/provider@4.0.36
+  - @ai-sdk/openai-compatible@3.0.85
+  - @ai-sdk/provider-utils@5.0.75
+
 ## 3.0.55
 
 ### Patch Changes

package/dist/index.js

@@ -46,7 +46,7 @@ const gmicloudErrorStructure = {
 };
 //#endregion
 //#region src/version.ts
-const VERSION = "3.0.55";
+const VERSION = "3.0.57";
 //#endregion
 //#region src/gmicloud-provider.ts
 function createGmicloud(options = {}) {

package/docs/100-gmicloud.mdx

@@ -121,3 +121,27 @@ GMI Cloud serves an evolving catalog of open-weight models, so model ids are typ
 ## 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`.
+
+## Model Capabilities
+
+{/* model-capabilities:gmicloud-language:start */}
+
+{/* model-capabilities:gmicloud-language:end */}
+
+## Provider Option Reference
+
+The following option definitions are generated from the provider catalog.
+
+{/* model-capabilities:gmicloud-provider-options:start */}
+
+| Operation | Option             | Description                                                                                                                                                                                                    |
+| --------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| language  | `user`             | A unique identifier representing your end-user, which can help providers to monitor and detect abuse.                                                                                                          |
+| language  | `reasoningEffort`  | Reasoning effort for reasoning models. Defaults to `medium`. Set to `null` to send `"reasoning_effort": null`, for providers that treat an explicit `null` differently from an omitted field.                  |
+| language  | `textVerbosity`    | Controls the verbosity of the generated text. Defaults to `medium`.                                                                                                                                            |
+| language  | `strictJsonSchema` | Whether to use strict JSON schema validation. When true, the model uses constrained decoding to guarantee schema compliance. Only used when the provider supports structured outputs and a schema is provided. |
+| language  | `echo`             | Echo back the prompt in addition to the completion.                                                                                                                                                            |
+| language  | `logitBias`        | Modify the likelihood of specified tokens appearing in the completion. Accepts a JSON object that maps tokens (specified by their token ID in the GPT tokenizer) to an associated bias value from -100 to 100. |
+| language  | `suffix`           | The suffix that comes after a completion of inserted text.                                                                                                                                                     |
+
+{/* model-capabilities:gmicloud-provider-options:end */}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/gmicloud",
-  "version": "3.0.55",
+  "version": "3.0.57",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -29,9 +29,9 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/openai-compatible": "3.0.84",
-    "@ai-sdk/provider": "4.0.35",
-    "@ai-sdk/provider-utils": "5.0.74"
+    "@ai-sdk/openai-compatible": "3.0.86",
+    "@ai-sdk/provider": "4.0.36",
+    "@ai-sdk/provider-utils": "5.0.75"
   },
   "devDependencies": {
     "@types/node": "22.19.19",

package/src/gmicloud-model-catalog.ts

@@ -0,0 +1,90 @@
+import type {
+  OpenAICompatibleLanguageModelChatOptions,
+  OpenAICompatibleLanguageModelCompletionOptions,
+} from '@ai-sdk/openai-compatible';
+import type {
+  ModelCapabilities,
+  ModelEntry,
+  ProviderOptionDefinition,
+  ProviderOptionDefinitions,
+} from '@ai-sdk/provider';
+import type { GmicloudLanguageModelChatOptions } from './gmicloud-chat-language-model-options';
+const compatiblelanguageProviderOptions = {
+  user: {
+    description:
+      'A unique identifier representing your end-user, which can help providers to\nmonitor and detect abuse.',
+  },
+  reasoningEffort: {
+    description:
+      'Reasoning effort for reasoning models. Defaults to `medium`.\n\nSet to `null` to send `"reasoning_effort": null`, for providers that treat\nan explicit `null` differently from an omitted field.',
+  },
+  textVerbosity: {
+    description:
+      'Controls the verbosity of the generated text. Defaults to `medium`.',
+  },
+  strictJsonSchema: {
+    description:
+      'Whether to use strict JSON schema validation.\nWhen true, the model uses constrained decoding to guarantee schema compliance.\nOnly used when the provider supports structured outputs and a schema is provided.',
+  },
+  echo: { description: 'Echo back the prompt in addition to the completion.' },
+  logitBias: {
+    description:
+      'Modify the likelihood of specified tokens appearing in the completion.\n\nAccepts a JSON object that maps tokens (specified by their token ID in\nthe GPT tokenizer) to an associated bias value from -100 to 100.',
+  },
+  suffix: {
+    description: 'The suffix that comes after a completion of inserted text.',
+  },
+} satisfies Record<
+  | keyof OpenAICompatibleLanguageModelChatOptions
+  | keyof OpenAICompatibleLanguageModelCompletionOptions,
+  ProviderOptionDefinition
+>;
+
+/** Known options accepted under providerOptions; open-ended extension keys remain undeclared. */
+export const gmicloudProviderOptions = {
+  language: {
+    ...compatiblelanguageProviderOptions,
+  } satisfies Record<
+    keyof GmicloudLanguageModelChatOptions,
+    ProviderOptionDefinition
+  >,
+} as const satisfies ProviderOptionDefinitions;
+
+const languageModelIds = [
+  'deepseek-ai/DeepSeek-V4-Flash-0731',
+  'Qwen/Qwen3.8-Max',
+  'moonshotai/kimi-k3',
+  'zai-org/GLM-5.2-FP8',
+  'MiniMaxAI/MiniMax-M3',
+] as const;
+const documentedLanguageCapabilities: Record<
+  string,
+  NonNullable<ModelCapabilities['language']>
+> = {};
+const unknownLanguageCapabilities: NonNullable<ModelCapabilities['language']> =
+  {
+    inputs: { image: 'unknown', audio: 'unknown' },
+    objectGeneration: 'unknown',
+    tools: { usage: 'unknown', streaming: 'unknown' },
+    reasoning: { support: 'unknown' },
+    sampling: { temperature: 'unknown', topP: 'unknown', logprobs: 'unknown' },
+  };
+export function getGmicloudLanguageModelEntry(modelId: string) {
+  return {
+    capabilities: {
+      language:
+        documentedLanguageCapabilities[modelId] ?? unknownLanguageCapabilities,
+    },
+    providerOptions: {
+      language: Object.fromEntries(
+        Object.keys(gmicloudProviderOptions.language).map(key => [
+          key,
+          'unknown' as const,
+        ]),
+      ),
+    },
+  } satisfies ModelEntry;
+}
+export const gmicloudModelCatalog = Object.fromEntries(
+  languageModelIds.map(id => [id, getGmicloudLanguageModelEntry(id)]),
+);