@core-ai/core-ai 0.12.0 → 0.13.0

package/dist/index.d.ts

@@ -85,9 +85,21 @@ type ToolChoice = 'auto' | 'none' | 'required' | {
     type: 'tool';
     toolName: string;
 };
+type ModelCapabilities = {
+    reasoning: {
+        supported: boolean;
+        supportedEfforts: readonly ReasoningEffort[];
+        /**
+         * When true, sampling parameters such as `temperature` and `topP`
+         * must not be set alongside `reasoning`.
+         */
+        restrictsSamplingParams: boolean;
+    };
+};
 type ChatModel = {
     readonly provider: string;
     readonly modelId: string;
+    readonly capabilities: ModelCapabilities;
     generate(options: GenerateOptions): Promise<GenerateResult>;
     stream(options: GenerateOptions): Promise<ChatStream>;
     generateObject<TSchema extends z.ZodType>(options: GenerateObjectOptions<TSchema>): Promise<GenerateObjectResult<TSchema>>;
@@ -369,6 +381,8 @@ declare function zodSchemaToJsonSchema(schema: z.ZodType): Record<string, unknow
 
 declare function stripModelDateSuffix(modelId: string): string;
 
+declare function clampReasoningEffort(effort: ReasoningEffort, supportedEfforts: readonly ReasoningEffort[]): ReasoningEffort;
+
 declare function asObject(value: unknown): Record<string, unknown>;
 declare function safeParseJsonObject(json: string): Record<string, unknown>;
 
@@ -432,4 +446,4 @@ type GenerateImageParams = ImageGenerateOptions & {
 };
 declare function generateImage(params: GenerateImageParams): Promise<ImageGenerateResult>;
 
-export { AbortedError, type AssistantContentPart, type AssistantMessage, type AssistantTextPart, type BaseGenerateOptions, type ChatInputTokenDetails, type ChatModel, type ChatModelMiddleware, type ChatOutputTokenDetails, type ChatStream, type ChatUsage, CoreAIError, type EmbedOptions, type EmbedProviderOptions, type EmbedResult, type EmbeddingModel, type EmbeddingModelMiddleware, type EmbeddingUsage, type FilePart, type FinishReason, type GenerateObjectOptions, type GenerateObjectResult, type GenerateOptions, type GenerateProviderOptions, type GenerateResult, type GeneratedImage, type ImageGenerateOptions, type ImageGenerateResult, type ImageModel, type ImageModelMiddleware, type ImagePart, type ImageProviderOptions, type Message, type ObjectStream, type ObjectStreamEvent, ProviderError, type ReasoningConfig, type ReasoningEffort, type ReasoningPart, StreamAbortedError, type StreamEvent, type StreamObjectOptions, StructuredOutputError, StructuredOutputNoObjectGeneratedError, StructuredOutputParseError, StructuredOutputValidationError, type SystemMessage, type TextPart, type ToolCall, type ToolCallPart, type ToolChoice, type ToolDefinition, type ToolResultMessage, type ToolSet, type UserContentPart, type UserMessage, ValidationError, asObject, assistantMessage, createChatStream, createObjectStream, defineTool, embed, generate, generateImage, generateObject, getProviderMetadata, resultToMessage, safeParseJsonObject, stream, streamObject, stripModelDateSuffix, wrapChatModel, wrapEmbeddingModel, wrapImageModel, zodSchemaToJsonSchema };
+export { AbortedError, type AssistantContentPart, type AssistantMessage, type AssistantTextPart, type BaseGenerateOptions, type ChatInputTokenDetails, type ChatModel, type ChatModelMiddleware, type ChatOutputTokenDetails, type ChatStream, type ChatUsage, CoreAIError, type EmbedOptions, type EmbedProviderOptions, type EmbedResult, type EmbeddingModel, type EmbeddingModelMiddleware, type EmbeddingUsage, type FilePart, type FinishReason, type GenerateObjectOptions, type GenerateObjectResult, type GenerateOptions, type GenerateProviderOptions, type GenerateResult, type GeneratedImage, type ImageGenerateOptions, type ImageGenerateResult, type ImageModel, type ImageModelMiddleware, type ImagePart, type ImageProviderOptions, type Message, type ModelCapabilities, type ObjectStream, type ObjectStreamEvent, ProviderError, type ReasoningConfig, type ReasoningEffort, type ReasoningPart, StreamAbortedError, type StreamEvent, type StreamObjectOptions, StructuredOutputError, StructuredOutputNoObjectGeneratedError, StructuredOutputParseError, StructuredOutputValidationError, type SystemMessage, type TextPart, type ToolCall, type ToolCallPart, type ToolChoice, type ToolDefinition, type ToolResultMessage, type ToolSet, type UserContentPart, type UserMessage, ValidationError, asObject, assistantMessage, clampReasoningEffort, createChatStream, createObjectStream, defineTool, embed, generate, generateImage, generateObject, getProviderMetadata, resultToMessage, safeParseJsonObject, stream, streamObject, stripModelDateSuffix, wrapChatModel, wrapEmbeddingModel, wrapImageModel, zodSchemaToJsonSchema };

package/dist/index.js

@@ -86,6 +86,35 @@ function stripModelDateSuffix(modelId) {
   return modelId.replace(MODEL_DATE_SUFFIX_PATTERN, "");
 }
 
+// src/model-capabilities.ts
+var EFFORT_RANK = {
+  minimal: 0,
+  low: 1,
+  medium: 2,
+  high: 3,
+  max: 4
+};
+function clampReasoningEffort(effort, supportedEfforts) {
+  if (supportedEfforts.includes(effort)) {
+    return effort;
+  }
+  const [firstSupportedEffort, ...remainingSupportedEfforts] = supportedEfforts;
+  if (firstSupportedEffort === void 0) {
+    return effort;
+  }
+  const targetRank = EFFORT_RANK[effort];
+  let best = firstSupportedEffort;
+  let bestDistance = Math.abs(EFFORT_RANK[best] - targetRank);
+  for (const candidate of remainingSupportedEfforts) {
+    const distance = Math.abs(EFFORT_RANK[candidate] - targetRank);
+    if (distance < bestDistance) {
+      best = candidate;
+      bestDistance = distance;
+    }
+  }
+  return best;
+}
+
 // src/provider-utils.ts
 function asObject(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
@@ -565,6 +594,7 @@ function wrapChatModel(config) {
   return {
     provider: model.provider,
     modelId: model.modelId,
+    capabilities: model.capabilities,
     generate(options) {
       return buildMiddlewareChain({
         model,
@@ -581,7 +611,9 @@ function wrapChatModel(config) {
     },
     generateObject(options) {
       const operations = middlewares.flatMap(
-        (mw) => mw.generateObject ? [mw.generateObject] : []
+        (mw) => mw.generateObject ? [
+          mw.generateObject
+        ] : []
       );
       return buildMiddlewareChain({
         model,
@@ -673,6 +705,7 @@ export {
   ValidationError,
   asObject,
   assistantMessage,
+  clampReasoningEffort,
   createChatStream,
   createObjectStream,
   defineTool,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@core-ai/core-ai",
-    "version": "0.12.0",
+    "version": "0.13.0",
     "description": "Type-safe LLM abstraction layer over native provider SDKs",
     "license": "MIT",
     "author": "Omnifact (https://omnifact.ai)",