@absolutejs/ai 0.2.8 → 0.2.10

package/dist/src/ai/inputCapacity.d.ts

@@ -18,7 +18,9 @@ export type AIInputCapacity = {
 };
 export declare class AIInputError extends Error {
     readonly code: "capacity_unavailable" | "input_too_large" | "unsupported_content";
-    constructor(code: "capacity_unavailable" | "input_too_large" | "unsupported_content", message: string);
+    readonly status?: number | undefined;
+    readonly requestId?: string | undefined;
+    constructor(code: "capacity_unavailable" | "input_too_large" | "unsupported_content", message: string, status?: number | undefined, requestId?: string | undefined);
 }
 export declare const positiveTokenLimit: (value: unknown) => number;
 export declare const inputTokenCount: (value: unknown) => number;

package/dist/src/ai/models/directory.d.ts

@@ -1,6 +1,7 @@
 import { modelCapabilities } from "./index";
 /** Display names for the providers the directory covers. */
 export declare const MODEL_PROVIDERS: Readonly<Record<string, string>>;
+export type ModelTier = "frontier" | "balanced" | "fast";
 export type ModelDirectoryEntry = {
     provider: string;
     /** The exact model ID sent to the provider. */
@@ -8,8 +9,10 @@ export type ModelDirectoryEntry = {
     name: string;
     /** One short, plain sentence for pickers. */
     description: string;
-    /** A current flagship worth showing first. */
+    /** The provider's current frontier model; at most one per provider. */
     featured?: boolean;
+    /** Relative capability within the provider's current line, for recommendations. */
+    tier?: ModelTier;
     /** Superseded by a newer model in the same line; hide by default. */
     legacy?: boolean;
 };
@@ -36,3 +39,20 @@ export declare const listModels: (options?: {
     includeLegacy?: boolean;
 }) => ListedModel[];
 export declare const findModel: (provider: string, id: string) => ModelDirectoryEntry | undefined;
+/** Chooses a tier from the request text: quick edits and simple questions are
+ * fast, deep analysis or very long requests are frontier, everything else is
+ * balanced. `depth: "deep"` forces frontier. Adapted from AbsoluteJS PAAS. */
+export declare const recommendTier: (input: {
+    message: string;
+    depth?: "auto" | "deep";
+}) => ModelTier;
+/** Picks a current model for a request from the first listed provider that
+ * has one at the recommended tier. Providers are in preference order and
+ * should only include ones the application can call. */
+export declare const recommendModel: (input: {
+    message: string;
+    providers: readonly string[];
+    depth?: "auto" | "deep";
+}) => (ModelDirectoryEntry & {
+    tier: ModelTier;
+}) | undefined;

package/dist/src/ai/models/index.d.ts

@@ -30,4 +30,4 @@ export type ModelCapability = keyof typeof MODEL_CAPABILITY_DESCRIPTIONS;
 export declare const modelCapabilities: (metadata?: ModelMetadata) => ModelCapability[];
 export { MODEL_METADATA, getModelMetadata } from "./catalog";
 export { MODEL_REASONING, REASONING_EFFORTS, getModelReasoning, isReasoningSelection, supportsReasoningSelection, reasoningSelectionLabel, type ModelReasoning, type ReasoningSelection, } from "./reasoning";
-export { MODEL_DIRECTORY, MODEL_PROVIDERS, findModel, listModels, modelKey, type ListedModel, type ModelDirectoryEntry, } from "./directory";
+export { MODEL_DIRECTORY, MODEL_PROVIDERS, findModel, listModels, modelKey, recommendModel, recommendTier, type ListedModel, type ModelDirectoryEntry, type ModelTier, } from "./directory";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/ai",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "homepage": "https://github.com/absolutejs/ai",
   "bugs": {
     "url": "https://github.com/absolutejs/ai/issues"