@shop-os/modelkit 0.2.9 → 0.2.11

package/dist/index.d.cts

@@ -106,6 +106,8 @@ interface VideoRequest {
     watermark?: boolean;
     /** Provider-side safety checker toggle (fal MiniMax). Provider default when unset. */
     safetyChecker?: boolean;
+    /** Seedance omni-reference subtask hint. `edit` forces duration -1 and adaptive ratio. */
+    taskType?: "reference" | "edit" | "extend";
     mode?: "standard" | "pro";
 }
 /**
@@ -157,9 +159,11 @@ interface MediaPart {
     cleanup?: () => Promise<void>;
 }
 type RequiredInput = "firstFrame" | "sourceVideo" | "references";
-type SupportedOption = "seed" | "quality" | "negativePrompt" | "cfgScale" | "generateAudio" | "promptExpansion" | "lastFrame" | "count" | "outputFormat" | "scaleFactor" | "safetySettings" | "temperature" | "upscale" | "watermark" | "safetyChecker" | "instrumental";
+type SupportedOption = "seed" | "quality" | "negativePrompt" | "cfgScale" | "generateAudio" | "promptExpansion" | "lastFrame" | "count" | "outputFormat" | "scaleFactor" | "safetySettings" | "temperature" | "upscale" | "watermark" | "safetyChecker" | "taskType" | "instrumental";
 interface ReferenceLimits {
     images?: number;
+    /** Lower image cap when a reference video is also sent (Kling V3 Omni: 7 → 4). */
+    imagesWithVideo?: number;
     videos?: number;
     audios?: number;
     total?: number;
@@ -367,17 +371,36 @@ type ProviderKeys = Partial<Record<ProviderKeyName, string>> & {
     higgsfieldSecret?: string;
     /** Bedrock runtime credentials for Anthropic models when routing.anthropic = "bedrock". */
     aws?: {
-        accessKeyId: string;
-        secretAccessKey: string;
+        /** Bedrock region. Must serve the chosen inference profile (us-east-1 for "us"). */
         region: string;
+        accessKeyId?: string;
+        secretAccessKey?: string;
         sessionToken?: string;
+        /** Bedrock API key (AWS_BEARER_TOKEN_BEDROCK). Wins over SigV4. */
+        apiKey?: string;
+        /** For ECS task roles and other chains. The kit has no AWS SDK dependency; the app passes e.g. defaultProvider(). */
+        credentialProvider?: () => PromiseLike<{
+            accessKeyId: string;
+            secretAccessKey: string;
+            sessionToken?: string;
+        }>;
     };
 };
+/** Key names a call can require, including the Bedrock credentials object. */
+type RequiredKeyName = ProviderKeyName | "aws";
+/** True when region is set AND (apiKey OR credentialProvider OR both static keys). */
+declare function hasAwsCredentials(aws: ProviderKeys["aws"]): aws is NonNullable<ProviderKeys["aws"]>;
 interface Routing {
     /** Text models: direct provider or the Cloudflare AI Gateway. */
     text?: "direct" | "cloudflare";
-    /** Anthropic chat via Bedrock (us. prefixed ids) or the Anthropic API. */
+    /**
+     * Anthropic chat via Bedrock or the Anthropic API. Default "direct". A row's
+     * `providerOptions.modelkit.transport` wins over this. When the chosen transport has
+     * no credentials and the other one has, the kit uses the other one and warns.
+     */
     anthropic?: "direct" | "bedrock";
+    /** Inference profile prefix for Bedrock ids. Default "us". */
+    bedrockProfile?: "us" | "global" | "eu" | "jp" | "au";
     /** fal from geo-blocked regions goes through the Cloudflare passthrough. */
     fal?: "direct" | "cloudflare-passthrough";
     cloudflare?: {
@@ -555,7 +578,7 @@ declare const ADAPTER_KEYS: Record<AdapterId, ProviderKeyName[]>;
  * enterprise tier; otherwise the pro keys are used. Mirrors trigger-workflows
  * enterprise-keys.ts, extended to Ark and Prodia.
  */
-declare function resolveKeys(config: ModelKitConfig, names: ProviderKeyName[], tier?: "pro" | "enterprise"): ProviderKeys;
+declare function resolveKeys(config: ModelKitConfig, names: RequiredKeyName[], tier?: "pro" | "enterprise"): ProviderKeys;
 /** Build a ProviderKeys map from env with the given prefix ("" for pro, "ENTERPRISE_" for enterprise). */
 declare function keysFromEnv(env: NodeJS.ProcessEnv, prefix?: string): ProviderKeys;
 
@@ -584,11 +607,16 @@ declare function pollUntil<T>(check: () => Promise<T | undefined>, opts: {
     maxIntervalMs?: number;
 }): Promise<T>;
 
+declare const ANTHROPIC_TRANSPORTS: readonly ["direct", "bedrock"];
+type AnthropicTransport = (typeof ANTHROPIC_TRANSPORTS)[number];
+
 /** Everything an adapter needs for one call. Resolved by the core before dispatch. */
 interface AdapterContext {
     model: CatalogModel;
     keys: ProviderKeys;
     routing: Routing;
+    /** Resolved transport of an Anthropic text row (see anthropic-transport.ts); unset means direct. */
+    anthropicTransport?: AnthropicTransport;
     endpoints?: AdapterEndpoints;
     fetch: typeof fetch;
     logger: Pick<Console, "debug" | "info" | "warn" | "error">;
@@ -778,4 +806,4 @@ declare function describeThrown(cause: unknown): ThrownErrorInfo;
 /** Add the AI SDK `GeneratedFile` accessors to adapter image bytes. base64 is computed on first read. */
 declare function toGeneratedImage(image: ImageBytes): GeneratedImage;
 
-export { ADAPTER_IDS, ADAPTER_KEYS, type Adapter, type AdapterContext, type AdapterEndpoints, type AdapterId, type AdapterRegistry, type AiTextProviderOptions, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, type CatalogOrigin, CatalogSchema, type CatalogSource, type CatalogTextModel, DEFAULT_ADAPTERS, type DefaultObjectOutput, type Exposure, ExposureSchema, type GeneratedImage, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, JsonObjectSchema, type JsonPrimitive, type JsonValue, JsonValueSchema, type LanguageModelHandle, type Lifecycle, type LiveCatalogState, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKit, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, type ModelkitGenerateObjectOptions, type ModelkitGenerateTextOptions, type ModelkitStreamObjectOptions, type ModelkitStreamTextOptions, type ObjectOutput, type ObjectResult, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type ReferenceLimits, type RequiredInput, type ResolveResult, type Routing, SURFACES, type SupportedOption, type Surface, SurfaceSchema, type TextMethods, type TextModelInstance, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type Warning, aiSdkTextAdapter, arkAdapter, aspectRatioToSize, classifyHttpError, compareCatalogOrder, createDefaultModelKit, createModelKit, describe, describeThrown, generateImage as experimental_generateImage, falAdapter, fileCatalogCache, generateAudio, generateImage, generateObject, generateText, generateVideo, googleGenaiAdapter, googleImageAdapter, higgsfieldAdapter, isListed, isListedOn, isModelKitError, keysFromEnv, languageModel, liveCatalog, liveState, mergeTextProviderOptions, nearestAspectRatio, normalizeExposure, openaiImageAdapter, passthroughTextModel, pollUntil, prepareMediaPart, primeCatalog, prodiaAdapter, readErrorBody, replicateAdapter, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveKeys, resolveVideoOptions, shouldRetry, sleep, sortCatalogRows, streamObject, streamText, textUsageEvent, toGeneratedImage, withRetry, xaiVideoAdapter };
+export { ADAPTER_IDS, ADAPTER_KEYS, type Adapter, type AdapterContext, type AdapterEndpoints, type AdapterId, type AdapterRegistry, type AiTextProviderOptions, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, type CatalogOrigin, CatalogSchema, type CatalogSource, type CatalogTextModel, DEFAULT_ADAPTERS, type DefaultObjectOutput, type Exposure, ExposureSchema, type GeneratedImage, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, JsonObjectSchema, type JsonPrimitive, type JsonValue, JsonValueSchema, type LanguageModelHandle, type Lifecycle, type LiveCatalogState, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKit, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, type ModelkitGenerateObjectOptions, type ModelkitGenerateTextOptions, type ModelkitStreamObjectOptions, type ModelkitStreamTextOptions, type ObjectOutput, type ObjectResult, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type ReferenceLimits, type RequiredInput, type RequiredKeyName, type ResolveResult, type Routing, SURFACES, type SupportedOption, type Surface, SurfaceSchema, type TextMethods, type TextModelInstance, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type Warning, aiSdkTextAdapter, arkAdapter, aspectRatioToSize, classifyHttpError, compareCatalogOrder, createDefaultModelKit, createModelKit, describe, describeThrown, generateImage as experimental_generateImage, falAdapter, fileCatalogCache, generateAudio, generateImage, generateObject, generateText, generateVideo, googleGenaiAdapter, googleImageAdapter, hasAwsCredentials, higgsfieldAdapter, isListed, isListedOn, isModelKitError, keysFromEnv, languageModel, liveCatalog, liveState, mergeTextProviderOptions, nearestAspectRatio, normalizeExposure, openaiImageAdapter, passthroughTextModel, pollUntil, prepareMediaPart, primeCatalog, prodiaAdapter, readErrorBody, replicateAdapter, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveKeys, resolveVideoOptions, shouldRetry, sleep, sortCatalogRows, streamObject, streamText, textUsageEvent, toGeneratedImage, withRetry, xaiVideoAdapter };

package/dist/index.d.ts

@@ -106,6 +106,8 @@ interface VideoRequest {
     watermark?: boolean;
     /** Provider-side safety checker toggle (fal MiniMax). Provider default when unset. */
     safetyChecker?: boolean;
+    /** Seedance omni-reference subtask hint. `edit` forces duration -1 and adaptive ratio. */
+    taskType?: "reference" | "edit" | "extend";
     mode?: "standard" | "pro";
 }
 /**
@@ -157,9 +159,11 @@ interface MediaPart {
     cleanup?: () => Promise<void>;
 }
 type RequiredInput = "firstFrame" | "sourceVideo" | "references";
-type SupportedOption = "seed" | "quality" | "negativePrompt" | "cfgScale" | "generateAudio" | "promptExpansion" | "lastFrame" | "count" | "outputFormat" | "scaleFactor" | "safetySettings" | "temperature" | "upscale" | "watermark" | "safetyChecker" | "instrumental";
+type SupportedOption = "seed" | "quality" | "negativePrompt" | "cfgScale" | "generateAudio" | "promptExpansion" | "lastFrame" | "count" | "outputFormat" | "scaleFactor" | "safetySettings" | "temperature" | "upscale" | "watermark" | "safetyChecker" | "taskType" | "instrumental";
 interface ReferenceLimits {
     images?: number;
+    /** Lower image cap when a reference video is also sent (Kling V3 Omni: 7 → 4). */
+    imagesWithVideo?: number;
     videos?: number;
     audios?: number;
     total?: number;
@@ -367,17 +371,36 @@ type ProviderKeys = Partial<Record<ProviderKeyName, string>> & {
     higgsfieldSecret?: string;
     /** Bedrock runtime credentials for Anthropic models when routing.anthropic = "bedrock". */
     aws?: {
-        accessKeyId: string;
-        secretAccessKey: string;
+        /** Bedrock region. Must serve the chosen inference profile (us-east-1 for "us"). */
         region: string;
+        accessKeyId?: string;
+        secretAccessKey?: string;
         sessionToken?: string;
+        /** Bedrock API key (AWS_BEARER_TOKEN_BEDROCK). Wins over SigV4. */
+        apiKey?: string;
+        /** For ECS task roles and other chains. The kit has no AWS SDK dependency; the app passes e.g. defaultProvider(). */
+        credentialProvider?: () => PromiseLike<{
+            accessKeyId: string;
+            secretAccessKey: string;
+            sessionToken?: string;
+        }>;
     };
 };
+/** Key names a call can require, including the Bedrock credentials object. */
+type RequiredKeyName = ProviderKeyName | "aws";
+/** True when region is set AND (apiKey OR credentialProvider OR both static keys). */
+declare function hasAwsCredentials(aws: ProviderKeys["aws"]): aws is NonNullable<ProviderKeys["aws"]>;
 interface Routing {
     /** Text models: direct provider or the Cloudflare AI Gateway. */
     text?: "direct" | "cloudflare";
-    /** Anthropic chat via Bedrock (us. prefixed ids) or the Anthropic API. */
+    /**
+     * Anthropic chat via Bedrock or the Anthropic API. Default "direct". A row's
+     * `providerOptions.modelkit.transport` wins over this. When the chosen transport has
+     * no credentials and the other one has, the kit uses the other one and warns.
+     */
     anthropic?: "direct" | "bedrock";
+    /** Inference profile prefix for Bedrock ids. Default "us". */
+    bedrockProfile?: "us" | "global" | "eu" | "jp" | "au";
     /** fal from geo-blocked regions goes through the Cloudflare passthrough. */
     fal?: "direct" | "cloudflare-passthrough";
     cloudflare?: {
@@ -555,7 +578,7 @@ declare const ADAPTER_KEYS: Record<AdapterId, ProviderKeyName[]>;
  * enterprise tier; otherwise the pro keys are used. Mirrors trigger-workflows
  * enterprise-keys.ts, extended to Ark and Prodia.
  */
-declare function resolveKeys(config: ModelKitConfig, names: ProviderKeyName[], tier?: "pro" | "enterprise"): ProviderKeys;
+declare function resolveKeys(config: ModelKitConfig, names: RequiredKeyName[], tier?: "pro" | "enterprise"): ProviderKeys;
 /** Build a ProviderKeys map from env with the given prefix ("" for pro, "ENTERPRISE_" for enterprise). */
 declare function keysFromEnv(env: NodeJS.ProcessEnv, prefix?: string): ProviderKeys;
 
@@ -584,11 +607,16 @@ declare function pollUntil<T>(check: () => Promise<T | undefined>, opts: {
     maxIntervalMs?: number;
 }): Promise<T>;
 
+declare const ANTHROPIC_TRANSPORTS: readonly ["direct", "bedrock"];
+type AnthropicTransport = (typeof ANTHROPIC_TRANSPORTS)[number];
+
 /** Everything an adapter needs for one call. Resolved by the core before dispatch. */
 interface AdapterContext {
     model: CatalogModel;
     keys: ProviderKeys;
     routing: Routing;
+    /** Resolved transport of an Anthropic text row (see anthropic-transport.ts); unset means direct. */
+    anthropicTransport?: AnthropicTransport;
     endpoints?: AdapterEndpoints;
     fetch: typeof fetch;
     logger: Pick<Console, "debug" | "info" | "warn" | "error">;
@@ -778,4 +806,4 @@ declare function describeThrown(cause: unknown): ThrownErrorInfo;
 /** Add the AI SDK `GeneratedFile` accessors to adapter image bytes. base64 is computed on first read. */
 declare function toGeneratedImage(image: ImageBytes): GeneratedImage;
 
-export { ADAPTER_IDS, ADAPTER_KEYS, type Adapter, type AdapterContext, type AdapterEndpoints, type AdapterId, type AdapterRegistry, type AiTextProviderOptions, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, type CatalogOrigin, CatalogSchema, type CatalogSource, type CatalogTextModel, DEFAULT_ADAPTERS, type DefaultObjectOutput, type Exposure, ExposureSchema, type GeneratedImage, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, JsonObjectSchema, type JsonPrimitive, type JsonValue, JsonValueSchema, type LanguageModelHandle, type Lifecycle, type LiveCatalogState, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKit, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, type ModelkitGenerateObjectOptions, type ModelkitGenerateTextOptions, type ModelkitStreamObjectOptions, type ModelkitStreamTextOptions, type ObjectOutput, type ObjectResult, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type ReferenceLimits, type RequiredInput, type ResolveResult, type Routing, SURFACES, type SupportedOption, type Surface, SurfaceSchema, type TextMethods, type TextModelInstance, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type Warning, aiSdkTextAdapter, arkAdapter, aspectRatioToSize, classifyHttpError, compareCatalogOrder, createDefaultModelKit, createModelKit, describe, describeThrown, generateImage as experimental_generateImage, falAdapter, fileCatalogCache, generateAudio, generateImage, generateObject, generateText, generateVideo, googleGenaiAdapter, googleImageAdapter, higgsfieldAdapter, isListed, isListedOn, isModelKitError, keysFromEnv, languageModel, liveCatalog, liveState, mergeTextProviderOptions, nearestAspectRatio, normalizeExposure, openaiImageAdapter, passthroughTextModel, pollUntil, prepareMediaPart, primeCatalog, prodiaAdapter, readErrorBody, replicateAdapter, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveKeys, resolveVideoOptions, shouldRetry, sleep, sortCatalogRows, streamObject, streamText, textUsageEvent, toGeneratedImage, withRetry, xaiVideoAdapter };
+export { ADAPTER_IDS, ADAPTER_KEYS, type Adapter, type AdapterContext, type AdapterEndpoints, type AdapterId, type AdapterRegistry, type AiTextProviderOptions, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, type CatalogOrigin, CatalogSchema, type CatalogSource, type CatalogTextModel, DEFAULT_ADAPTERS, type DefaultObjectOutput, type Exposure, ExposureSchema, type GeneratedImage, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, JsonObjectSchema, type JsonPrimitive, type JsonValue, JsonValueSchema, type LanguageModelHandle, type Lifecycle, type LiveCatalogState, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKit, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, type ModelkitGenerateObjectOptions, type ModelkitGenerateTextOptions, type ModelkitStreamObjectOptions, type ModelkitStreamTextOptions, type ObjectOutput, type ObjectResult, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type ReferenceLimits, type RequiredInput, type RequiredKeyName, type ResolveResult, type Routing, SURFACES, type SupportedOption, type Surface, SurfaceSchema, type TextMethods, type TextModelInstance, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type Warning, aiSdkTextAdapter, arkAdapter, aspectRatioToSize, classifyHttpError, compareCatalogOrder, createDefaultModelKit, createModelKit, describe, describeThrown, generateImage as experimental_generateImage, falAdapter, fileCatalogCache, generateAudio, generateImage, generateObject, generateText, generateVideo, googleGenaiAdapter, googleImageAdapter, hasAwsCredentials, higgsfieldAdapter, isListed, isListedOn, isModelKitError, keysFromEnv, languageModel, liveCatalog, liveState, mergeTextProviderOptions, nearestAspectRatio, normalizeExposure, openaiImageAdapter, passthroughTextModel, pollUntil, prepareMediaPart, primeCatalog, prodiaAdapter, readErrorBody, replicateAdapter, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveKeys, resolveVideoOptions, shouldRetry, sleep, sortCatalogRows, streamObject, streamText, textUsageEvent, toGeneratedImage, withRetry, xaiVideoAdapter };