nuabase 2.3.3 → 2.3.4

package/README.md

@@ -146,33 +146,33 @@ Every call returns a discriminated union. When `success` is `false`, you get an
 
 **Success**
 
-| Field       | Type                                                      | Description                                             |
-| ----------- | --------------------------------------------------------- | ------------------------------------------------------- |
-| `success`   | `true`                                                    | Indicates that the request completed successfully.      |
-| `data`      | `T` (for `get`) or `Array<{ [pk]: value; [output]: T }>` (for `list`) | The typed result matching your schema.    |
-| `usage`     | `{ promptTokens, completionTokens, totalTokens }`         | Token usage statistics for the LLM request.             |
-| `model`     | `string`                                                  | The LLM model used for this request.                    |
-| `latencyMs` | `number`                                                  | Request latency in milliseconds.                        |
-| `source`    | `'gateway'` \| `'direct'`                                 | Which backend processed the request.                    |
-| `meta`      | `object`                                                  | Additional metadata (varies by source).                 |
+| Field       | Type                                                                  | Description                                        |
+| ----------- | --------------------------------------------------------------------- | -------------------------------------------------- |
+| `success`   | `true`                                                                | Indicates that the request completed successfully. |
+| `data`      | `T` (for `get`) or `Array<{ [pk]: value; [output]: T }>` (for `list`) | The typed result matching your schema.             |
+| `usage`     | `{ promptTokens, completionTokens, totalTokens }`                     | Token usage statistics for the LLM request.        |
+| `model`     | `string`                                                              | The LLM model used for this request.               |
+| `latencyMs` | `number`                                                              | Request latency in milliseconds.                   |
+| `source`    | `'gateway'` \| `'direct'`                                             | Which backend processed the request.               |
+| `meta`      | `object`                                                              | Additional metadata (varies by source).            |
 
 **Gateway-specific metadata** (`meta` when `source` is `'gateway'`):
 
-| Field        | Type      | Description                                    |
-| ------------ | --------- | ---------------------------------------------- |
-| `requestId`  | `string`  | Unique identifier for tracing.                 |
-| `cached`     | `boolean` | Whether the result was served from cache.      |
-| `llmUsage`   | `object`  | Token usage from LLM calls.                    |
-| `cacheUsage` | `object`  | Token usage served from cache.                 |
+| Field        | Type      | Description                               |
+| ------------ | --------- | ----------------------------------------- |
+| `requestId`  | `string`  | Unique identifier for tracing.            |
+| `cached`     | `boolean` | Whether the result was served from cache. |
+| `llmUsage`   | `object`  | Token usage from LLM calls.               |
+| `cacheUsage` | `object`  | Token usage served from cache.            |
 
 **Error**
 
-| Field       | Type                          | Description                                              |
-| ----------- | ----------------------------- | -------------------------------------------------------- |
-| `success`   | `false`                       | Indicates the request failed.                            |
-| `error`     | `string`                      | Message describing the error.                            |
-| `source`    | `'gateway'` \| `'direct'`     | Which backend returned the error.                        |
-| `latencyMs` | `number`                      | Time until failure in milliseconds.                      |
+| Field       | Type                      | Description                         |
+| ----------- | ------------------------- | ----------------------------------- |
+| `success`   | `false`                   | Indicates the request failed.       |
+| `error`     | `string`                  | Message describing the error.       |
+| `source`    | `'gateway'` \| `'direct'` | Which backend returned the error.   |
+| `latencyMs` | `number`                  | Time until failure in milliseconds. |
 
 ## SDK API
 
@@ -187,8 +187,22 @@ Creates a client that connects to the Nuabase API gateway. Use this for producti
 **`Nua.direct(config)`**
 Creates a client that calls LLM providers directly (in-process). Use this for serverless, edge functions, or CLI tools where you don't need the gateway infrastructure.
 
-- `model: string` – The model to use (e.g., `'gpt-4o-mini'`).
-- `providers: { openai?: { apiKey: string }, ... }` – Provider credentials.
+- `model?: ModelInput` – Optional default model. Omit it to use `{ alias: 'fast' }`.
+- `providers: { groq?: { apiKey: string }, cerebras?: { apiKey: string }, gemini?: { apiKey: string }, openrouter?: { apiKey: string } }` – Provider credentials.
+
+Model inputs are objects, not provider-prefixed strings:
+
+```ts
+await nua.get('Extract the company name', {
+  output: { name: 'companyName', schema: z.string() },
+  model: { provider: 'openrouter', model: 'z-ai/glm-5.2' },
+});
+
+await nua.get('Extract the company name', {
+  output: { name: 'companyName', schema: z.string() },
+  model: { alias: 'fast' },
+});
+```
 
 ### Methods
 
@@ -196,7 +210,7 @@ Creates a client that calls LLM providers directly (in-process). Use this for se
 Returns a simple string response from the LLM.
 
 ```ts
-const result = await nua.get("Tell me a joke");
+const result = await nua.get('Tell me a joke');
 if (result.success) console.log(result.data); // string
 ```
 
@@ -208,8 +222,8 @@ Returns a typed single value. Parameters:
 - `options.output: { name: string; schema: ZodSchema }` – Output name and Zod schema.
 
 ```ts
-const result = await nua.get("Extract the address", {
-  input: "123 Main St, Springfield, IL 62701",
+const result = await nua.get('Extract the address', {
+  input: '123 Main St, Springfield, IL 62701',
   output: { name: 'address', schema: AddressSchema },
 });
 if (result.success) console.log(result.data); // typed as z.infer<typeof AddressSchema>
@@ -224,20 +238,20 @@ Processes an array of items. Parameters:
 - `options.output: { name: string; schema: ZodSchema }` – Output configuration.
 
 ```ts
-const result = await nua.list("Classify each lead", {
+const result = await nua.list('Classify each lead', {
   input: leads,
   primaryKey: 'id',
   output: { name: 'classification', schema: ClassificationSchema },
 });
 if (result.success) {
-  result.data.forEach(row => console.log(row.id, row.classification));
+  result.data.forEach((row) => console.log(row.id, row.classification));
 }
 ```
 
-**`nua.queueGet(prompt, options?)`** *(Gateway mode only)*
+**`nua.queueGet(prompt, options?)`** _(Gateway mode only)_
 Submits an async job for single-value operations. Returns `{ success: true, jobId }`.
 
-**`nua.queueList(prompt, options)`** *(Gateway mode only)*
+**`nua.queueList(prompt, options)`** _(Gateway mode only)_
 Submits an async job for array operations. Returns `{ success: true, jobId }`.
 
 ## Next Steps

package/dist/cjs/index.cjs

@@ -14,7 +14,6 @@ function requireLogger() {
   hasRequiredLogger = 1;
   Object.defineProperty(logger, "__esModule", { value: true });
   logger.logLlmCallError = logger.logLlmCallComplete = logger.logLlmCallStart = logger.generateSpanId = logger.ConsoleLogger = void 0;
-  logger.truncateText = truncateText;
   logger.pickHeaders = pickHeaders;
   logger.normalizeError = normalizeError;
   class ConsoleLogger {
@@ -34,13 +33,6 @@ function requireLogger() {
   logger.ConsoleLogger = ConsoleLogger;
   const generateSpanId = () => crypto.randomUUID();
   logger.generateSpanId = generateSpanId;
-  function truncateText(text, limit = 500) {
-    const length = text.length;
-    if (length <= limit) {
-      return { preview: text, length };
-    }
-    return { preview: text.slice(0, limit), length };
-  }
   function pickHeaders(headers, allowlist, redactSet) {
     const result = {};
     for (const [key, value] of Object.entries(headers)) {
@@ -75,16 +67,13 @@ function requireLogger() {
   };
   logger.logLlmCallStart = logLlmCallStart;
   const logLlmCallComplete = (logger2, spanId, service, method, response, duration) => {
-    const { headers, responseText, ...rest } = response;
-    const { preview: responsePreview, length: responseLength } = truncateText(responseText);
+    const { headers, ...rest } = response;
     logger2.info("LLM call completed", {
       type: "llm_call_complete",
       span_id: spanId,
       service,
       method,
       ...rest,
-      responsePreview,
-      responseLength,
       ...pickHeaders(headers, LLM_RESPONSE_HEADER_ALLOWLIST),
       duration_ms: duration
     });
@@ -9510,170 +9499,6 @@ function requireNuaJsonSchemaValueValidation() {
 
 var httpLlmClient = {};
 
-var modelInfo = {};
-
-var hasRequiredModelInfo;
-function requireModelInfo() {
-  if (hasRequiredModelInfo) return modelInfo;
-  hasRequiredModelInfo = 1;
-  (function(exports$1) {
-    Object.defineProperty(exports$1, "__esModule", { value: true });
-    exports$1.SUPPORTED_MODELS = exports$1.CANONICAL_MODELS = void 0;
-    exports$1.parseCanonicalModelName = parseCanonicalModelName;
-    exports$1.CANONICAL_MODELS = [
-      "qwen3-30b-a3b-instruct-2507",
-      "claude-opus-4-7",
-      "claude-sonnet-4-6",
-      "claude-haiku-4-5",
-      "qwen3-vl-235b-a22b-instruct",
-      "qwen3-max",
-      "gpt-5",
-      "gemini-2.5-flash-lite",
-      "gemini-2.5-flash",
-      "qwen3-coder-flash",
-      "gpt-oss-120b",
-      "kimi-k2.5",
-      "kimi-k2.6"
-    ];
-    const CANONICAL_SET = new Set(exports$1.CANONICAL_MODELS);
-    exports$1.SUPPORTED_MODELS = {
-      "gpt-oss-120b": [
-        {
-          provider: "cerebras",
-          providerModelName: "gpt-oss-120b"
-        },
-        {
-          provider: "groq",
-          providerModelName: "openai/gpt-oss-120b"
-        },
-        {
-          provider: "openrouter",
-          providerModelName: "openai/gpt-oss-120b"
-        }
-      ],
-      "qwen3-30b-a3b-instruct-2507": [
-        {
-          provider: "openrouter",
-          providerModelName: "qwen/qwen3-30b-a3b-instruct-2507"
-        }
-      ],
-      "claude-opus-4-7": [
-        {
-          provider: "openrouter",
-          providerModelName: "anthropic/claude-opus-4.7"
-        }
-      ],
-      "claude-sonnet-4-6": [
-        {
-          provider: "openrouter",
-          providerModelName: "anthropic/claude-sonnet-4.6"
-        }
-      ],
-      "claude-haiku-4-5": [
-        {
-          provider: "openrouter",
-          providerModelName: "anthropic/claude-haiku-4.5"
-        }
-      ],
-      "qwen3-vl-235b-a22b-instruct": [
-        {
-          provider: "openrouter",
-          providerModelName: "qwen/qwen3-vl-235b-a22b-instruct"
-        }
-      ],
-      "qwen3-max": [
-        {
-          provider: "openrouter",
-          providerModelName: "qwen/qwen3-max"
-        }
-      ],
-      "gpt-5": [
-        {
-          provider: "openrouter",
-          providerModelName: "openai/gpt-5"
-        }
-      ],
-      "gemini-2.5-flash-lite": [
-        {
-          provider: "gemini",
-          providerModelName: "gemini-2.5-flash-lite"
-        },
-        {
-          provider: "openrouter",
-          providerModelName: "google/gemini-2.5-flash-lite"
-        }
-      ],
-      "gemini-2.5-flash": [
-        {
-          provider: "gemini",
-          providerModelName: "gemini-2.5-flash"
-        },
-        {
-          provider: "openrouter",
-          providerModelName: "google/gemini-2.5-flash"
-        }
-      ],
-      "qwen3-coder-flash": [
-        {
-          provider: "openrouter",
-          providerModelName: "qwen/qwen3-coder-flash"
-        }
-      ],
-      "kimi-k2.5": [
-        {
-          provider: "openrouter",
-          providerModelName: "moonshotai/kimi-k2.5"
-        }
-      ],
-      "kimi-k2.6": [
-        {
-          provider: "openrouter",
-          providerModelName: "moonshotai/kimi-k2.6"
-        }
-      ]
-    };
-    function parseCanonicalModelName(requestedModel) {
-      let m = requestedModel || "fast";
-      if (CANONICAL_SET.has(m))
-        return m;
-      let m2;
-      switch (m) {
-        case "fast":
-          m2 = "gpt-oss-120b";
-          break;
-        case "gemini":
-          m2 = "gemini-2.5-flash";
-          break;
-        case "qwen":
-          m2 = "qwen3-vl-235b-a22b-instruct";
-          break;
-        case "sonnet":
-          m2 = "claude-sonnet-4-6";
-          break;
-        case "opus":
-          m2 = "claude-opus-4-7";
-          break;
-        case "haiku":
-          m2 = "claude-haiku-4-5";
-          break;
-        case "kimi":
-          m2 = "kimi-k2.6";
-          break;
-        case "gpt":
-          m2 = "gpt-5";
-          break;
-      }
-      if (m2)
-        return m2;
-      return {
-        kind: "validation-error",
-        message: `Invalid model name: ${m ?? "null/undefined"}`
-      };
-    }
-  })(modelInfo);
-  return modelInfo;
-}
-
 var providerConfig = {};
 
 var hasRequiredProviderConfig;
@@ -9682,7 +9507,13 @@ function requireProviderConfig() {
   hasRequiredProviderConfig = 1;
   (function(exports$1) {
     Object.defineProperty(exports$1, "__esModule", { value: true });
-    exports$1.providerConfigs = exports$1.extractOpenAiMessageText = exports$1.normalizeGeminiUsage = exports$1.normalizeOpenAiUsage = exports$1.normalizedUsageZero = void 0;
+    exports$1.providerConfigs = exports$1.extractOpenAiMessageText = exports$1.normalizeGeminiUsage = exports$1.normalizeOpenAiUsage = exports$1.normalizedUsageZero = exports$1.LLM_PROVIDER_IDS = void 0;
+    exports$1.LLM_PROVIDER_IDS = [
+      "groq",
+      "cerebras",
+      "gemini",
+      "openrouter"
+    ];
     exports$1.normalizedUsageZero = {
       promptTokens: 0,
       completionTokens: 0,
@@ -10381,7 +10212,6 @@ function requireHttpLlmClient() {
   hasRequiredHttpLlmClient = 1;
   Object.defineProperty(httpLlmClient, "__esModule", { value: true });
   httpLlmClient.HttpLlmClient = void 0;
-  const model_info_1 = requireModelInfo();
   const logger_1 = requireLogger();
   const provider_config_1 = requireProviderConfig();
   const provider_formatters_1 = requireProviderFormatters();
@@ -10393,10 +10223,9 @@ function requireHttpLlmClient() {
     }
     async sendRequest(prompt, model, maxTokens, assistantPrefillPrompt) {
       const provider = this.getProviderConfig();
-      const providerModelName = this.getProviderModelName(model);
       const requestOptions = provider.buildRequest({
         prompt,
-        model: providerModelName,
+        model,
         maxTokens,
         assistantPrefillPrompt
       }, this.apiKey);
@@ -10407,18 +10236,17 @@ function requireHttpLlmClient() {
         apiOperation: provider.apiOperation,
         requestOptions,
         parseResponse: provider.parseResponse,
-        getResponsePreview: (parsedResponse) => parsedResponse.text,
+        getResponseLength: (parsedResponse) => parsedResponse.text.length,
         getUsage: (parsedResponse) => parsedResponse.usage
       });
     }
     async sendAgenticRequest(messages, tools, model, maxTokens, systemPrompt, onEvent) {
       const provider = this.getProviderConfig();
-      const providerModelName = this.getProviderModelName(model);
       const codec = this.getAgenticProviderCodec(provider.errorLabel);
       const requestOptions = codec.buildRequest({
         messages,
         tools,
-        model: providerModelName,
+        model,
         maxTokens,
         systemPrompt,
         stream: !!onEvent
@@ -10431,7 +10259,7 @@ function requireHttpLlmClient() {
         apiOperation: "agentic",
         requestOptions,
         parseResponse,
-        getResponsePreview: (parsedResponse) => parsedResponse.message.content.filter((content) => content.type === "text").map((content) => content.text).join(""),
+        getResponseLength: (parsedResponse) => parsedResponse.message.content.reduce((total, content) => total + (content.type === "text" ? content.text.length : 0), 0),
         getUsage: (parsedResponse) => parsedResponse.usage
       });
     }
@@ -10442,13 +10270,6 @@ function requireHttpLlmClient() {
       }
       return provider;
     }
-    getProviderModelName(model) {
-      const providerSpecificModelName = model_info_1.SUPPORTED_MODELS[model].find((pm) => pm.provider === this.providerId);
-      if (!providerSpecificModelName) {
-        throw new Error(`LLM Provider ${this.providerId} does not support model ${model}. If this is an error and the provider does support this model, please contact us to fix it`);
-      }
-      return providerSpecificModelName.providerModelName;
-    }
     async executeProviderCall(params) {
       const method = params.requestOptions.method ?? "POST";
       const headers = params.requestOptions.headers ?? {};
@@ -10471,7 +10292,7 @@ function requireHttpLlmClient() {
         const duration = Date.now() - startTime;
         (0, logger_1.logLlmCallComplete)(this.logger, spanId, params.provider.providerId, params.apiOperation, {
           status: response.status,
-          responseText: params.getResponsePreview(parsedResponse),
+          responseLength: params.getResponseLength(parsedResponse),
           headers: Object.fromEntries(response.headers.entries()),
           usage: params.getUsage(parsedResponse)
         }, duration);
@@ -10526,6 +10347,112 @@ function requireHttpLlmClient() {
   return httpLlmClient;
 }
 
+var modelInfo = {};
+
+var hasRequiredModelInfo;
+function requireModelInfo() {
+  if (hasRequiredModelInfo) return modelInfo;
+  hasRequiredModelInfo = 1;
+  (function(exports$1) {
+    Object.defineProperty(exports$1, "__esModule", { value: true });
+    exports$1.MODEL_ALIAS_NAMES = exports$1.MODEL_ALIASES = void 0;
+    exports$1.isLlmProviderId = isLlmProviderId;
+    exports$1.isModelAliasName = isModelAliasName;
+    exports$1.resolveModelInput = resolveModelInput;
+    const provider_config_1 = requireProviderConfig();
+    exports$1.MODEL_ALIASES = {
+      fast: [
+        { provider: "cerebras", model: "gpt-oss-120b" },
+        { provider: "groq", model: "openai/gpt-oss-120b" },
+        { provider: "openrouter", model: "openai/gpt-oss-120b" }
+      ],
+      gemini: [
+        { provider: "gemini", model: "gemini-2.5-flash" },
+        { provider: "openrouter", model: "google/gemini-2.5-flash" }
+      ],
+      qwen: [
+        { provider: "openrouter", model: "qwen/qwen3-vl-235b-a22b-instruct" }
+      ],
+      sonnet: [
+        { provider: "openrouter", model: "anthropic/claude-sonnet-4.6" }
+      ],
+      opus: [
+        { provider: "openrouter", model: "anthropic/claude-opus-4.7" }
+      ],
+      haiku: [
+        { provider: "openrouter", model: "anthropic/claude-haiku-4.5" }
+      ],
+      kimi: [
+        { provider: "openrouter", model: "moonshotai/kimi-k2.6" }
+      ],
+      gpt: [
+        { provider: "openrouter", model: "openai/gpt-5" }
+      ]
+    };
+    exports$1.MODEL_ALIAS_NAMES = Object.keys(exports$1.MODEL_ALIASES);
+    const MODEL_ALIAS_SET = new Set(exports$1.MODEL_ALIAS_NAMES);
+    const LLM_PROVIDER_ID_SET = new Set(provider_config_1.LLM_PROVIDER_IDS);
+    function isLlmProviderId(value) {
+      return typeof value === "string" && LLM_PROVIDER_ID_SET.has(value);
+    }
+    function isModelAliasName(value) {
+      return typeof value === "string" && MODEL_ALIAS_SET.has(value);
+    }
+    function validationError(message) {
+      return {
+        kind: "validation-error",
+        message
+      };
+    }
+    function validateProviderModel(input, configuredProviders) {
+      if (!isLlmProviderId(input.provider)) {
+        return validationError(`Invalid LLM provider: ${String(input.provider)}`);
+      }
+      if (!configuredProviders.has(input.provider)) {
+        return validationError(`LLM provider ${input.provider} is not configured. Please check your API keys.`);
+      }
+      if (typeof input.model !== "string") {
+        return validationError("model.model must be a string");
+      }
+      const model = input.model.trim();
+      if (!model) {
+        return validationError("model.model must be a non-empty string");
+      }
+      if (input.provider === "gemini" && model.startsWith("models/")) {
+        return validationError('Gemini model names must use bare model IDs, for example "gemini-2.5-flash", not "models/gemini-2.5-flash".');
+      }
+      return {
+        provider: input.provider,
+        model
+      };
+    }
+    function resolveModelInput(input, configuredProviders) {
+      if (input == null) {
+        return resolveModelInput({ alias: "fast" }, configuredProviders);
+      }
+      if (typeof input !== "object") {
+        return validationError("model must be an object with either alias or provider/model fields");
+      }
+      if ("provider" in input || "model" in input) {
+        return validateProviderModel(input, configuredProviders);
+      }
+      if ("alias" in input) {
+        const alias = input.alias;
+        if (!isModelAliasName(alias)) {
+          return validationError(`Invalid model alias: ${String(alias)}`);
+        }
+        const configuredTarget = exports$1.MODEL_ALIASES[alias].find((target) => configuredProviders.has(target.provider));
+        if (!configuredTarget) {
+          return validationError(`No configured provider found for model alias ${alias}. Please check your API keys.`);
+        }
+        return configuredTarget;
+      }
+      return validationError("model must include either alias or provider/model fields");
+    }
+  })(modelInfo);
+  return modelInfo;
+}
+
 var castArrayPromptBuilder = {};
 
 var promptTemplateUtils = {};
@@ -10828,28 +10755,26 @@ function requireNuaLlmClient() {
         }
       });
     }
-    getClientForModel(model) {
-      const supported = model_info_1.SUPPORTED_MODELS[model];
-      if (!supported || supported.length === 0) {
-        throw new Error(`Model ${model} is not supported or configuration is missing.`);
-      }
-      for (const option of supported) {
-        if (this.clients.has(option.provider)) {
-          return this.clients.get(option.provider);
-        }
-      }
-      throw new Error(`No configured provider found for model ${model}. Please check your API keys.`);
+    getConfiguredProviderIds() {
+      return new Set(this.clients.keys());
     }
-    resolveModel(modelName) {
-      const result = (0, model_info_1.parseCanonicalModelName)(modelName);
+    resolveModel(model) {
+      const result = (0, model_info_1.resolveModelInput)(model, this.getConfiguredProviderIds());
       if ((0, nua_errors_1.isNuaValidationError)(result)) {
         throw new Error(result.message);
       }
       return result;
     }
+    getClientForProvider(provider) {
+      const client = this.clients.get(provider);
+      if (!client) {
+        throw new Error(`LLM provider ${provider} is not configured. Please check your API keys.`);
+      }
+      return client;
+    }
     async castValue(params) {
-      const model = this.resolveModel(params.model);
-      const client = this.getClientForModel(model);
+      const providerModel = this.resolveModel(params.model);
+      const client = this.getClientForProvider(providerModel.provider);
       const maxTokens = params.maxTokens || 4096;
       const temperature = params.temperature ?? 0;
       const prompt = cast_prompt_builder_1.default.buildFullPrompt(params);
@@ -10858,7 +10783,7 @@ function requireNuaLlmClient() {
         const result = await (0, call_llm_service_1.callLLM)(
           client,
           prompt,
-          model,
+          providerModel.model,
           maxTokens,
           temperature,
           3,
@@ -10880,8 +10805,8 @@ function requireNuaLlmClient() {
       }
     }
     async castArray(params) {
-      const model = this.resolveModel(params.model);
-      const client = this.getClientForModel(model);
+      const providerModel = this.resolveModel(params.model);
+      const client = this.getClientForProvider(providerModel.provider);
       const maxTokens = params.maxTokens || 4096;
       const temperature = params.temperature ?? 0;
       const validData = (0, validate_mappable_input_data_1.validateMappableInputData)(params.data, params.input.primaryKey);
@@ -10894,7 +10819,7 @@ function requireNuaLlmClient() {
       const prompt = cast_array_prompt_builder_1.default.buildFullPrompt(params, validData);
       const validationFn = (0, nua_json_schema_value_validation_1.buildNuaJsonSchemaValueValidation)("library-req", params.output.effectiveSchema);
       try {
-        const result = await (0, call_llm_service_1.callLLM)(client, prompt, model, maxTokens, temperature, 3, validationFn);
+        const result = await (0, call_llm_service_1.callLLM)(client, prompt, providerModel.model, maxTokens, temperature, 3, validationFn);
         return {
           success: true,
           data: result.data,
@@ -10911,8 +10836,8 @@ function requireNuaLlmClient() {
     }
     async runAgent(params) {
       try {
-        const model = this.resolveModel(params.model);
-        const client = this.getClientForModel(model);
+        const providerModel = this.resolveModel(params.model);
+        const client = this.getClientForProvider(providerModel.provider);
         const maxTokens = params.maxTokens ?? 4096;
         const maxTurns = params.maxTurns ?? 10;
         return (0, agent_loop_1.runAgentLoop)({
@@ -10921,7 +10846,7 @@ function requireNuaLlmClient() {
           systemPrompt: params.systemPrompt,
           maxTurns,
           onEvent: params.onEvent,
-          sendRequest: (messages, tools, systemPrompt) => client.sendAgenticRequest(messages, tools, model, maxTokens, systemPrompt, params.onEvent)
+          sendRequest: (messages, tools, systemPrompt) => client.sendAgenticRequest(messages, tools, providerModel.model, maxTokens, systemPrompt, params.onEvent)
         });
       } catch (e) {
         return {
@@ -11106,7 +11031,7 @@ function requireDist() {
       return mod && mod.__esModule ? mod : { "default": mod };
     };
     Object.defineProperty(exports$1, "__esModule", { value: true });
-    exports$1.runAgentLoop = exports$1.stableStringify = exports$1.validateJsonSchema = exports$1.providerConfigs = exports$1.normalizedUsageZero = exports$1.castArrayPromptBuilder = exports$1.castPromptBuilder = void 0;
+    exports$1.runAgentLoop = exports$1.stableStringify = exports$1.validateJsonSchema = exports$1.providerConfigs = exports$1.normalizedUsageZero = exports$1.LLM_PROVIDER_IDS = exports$1.castArrayPromptBuilder = exports$1.castPromptBuilder = void 0;
     __exportStar(requireNuaLlmClient(), exports$1);
     __exportStar(requireLogger(), exports$1);
     __exportStar(requireTypes(), exports$1);
@@ -11120,6 +11045,9 @@ function requireDist() {
       return __importDefault(cast_array_prompt_builder_1).default;
     } });
     var provider_config_1 = requireProviderConfig();
+    Object.defineProperty(exports$1, "LLM_PROVIDER_IDS", { enumerable: true, get: function() {
+      return provider_config_1.LLM_PROVIDER_IDS;
+    } });
     Object.defineProperty(exports$1, "normalizedUsageZero", { enumerable: true, get: function() {
       return provider_config_1.normalizedUsageZero;
     } });
@@ -11153,9 +11081,6 @@ const normalizedUsageZero = {
 };
 class DirectBackend {
   constructor(config) {
-    if (!config.model) {
-      throw new Error("model is required for direct mode");
-    }
     this.model = config.model;
     this.client = new distExports.NuaLlmClient({ providers: config.providers });
   }
@@ -11180,7 +11105,7 @@ class DirectBackend {
       success: true,
       data: result.data,
       usage: result.usage || normalizedUsageZero,
-      model,
+      model: formatModelInput(model),
       latencyMs,
       source: "direct",
       meta: {}
@@ -11212,13 +11137,18 @@ class DirectBackend {
       success: true,
       data: result.data,
       usage: result.usage || normalizedUsageZero,
-      model,
+      model: formatModelInput(model),
       latencyMs,
       source: "direct",
       meta: {}
     };
   }
 }
+function formatModelInput(model) {
+  if (!model) return "fast";
+  if ("alias" in model) return model.alias;
+  return `${model.provider}:${model.model}`;
+}
 
 function resolveConfigValue(config, key, envVar) {
   if (config[key]) return config[key];

package/dist/esm/index.mjs

@@ -13,7 +13,6 @@ function requireLogger() {
   hasRequiredLogger = 1;
   Object.defineProperty(logger, "__esModule", { value: true });
   logger.logLlmCallError = logger.logLlmCallComplete = logger.logLlmCallStart = logger.generateSpanId = logger.ConsoleLogger = void 0;
-  logger.truncateText = truncateText;
   logger.pickHeaders = pickHeaders;
   logger.normalizeError = normalizeError;
   class ConsoleLogger {
@@ -33,13 +32,6 @@ function requireLogger() {
   logger.ConsoleLogger = ConsoleLogger;
   const generateSpanId = () => crypto.randomUUID();
   logger.generateSpanId = generateSpanId;
-  function truncateText(text, limit = 500) {
-    const length = text.length;
-    if (length <= limit) {
-      return { preview: text, length };
-    }
-    return { preview: text.slice(0, limit), length };
-  }
   function pickHeaders(headers, allowlist, redactSet) {
     const result = {};
     for (const [key, value] of Object.entries(headers)) {
@@ -74,16 +66,13 @@ function requireLogger() {
   };
   logger.logLlmCallStart = logLlmCallStart;
   const logLlmCallComplete = (logger2, spanId, service, method, response, duration) => {
-    const { headers, responseText, ...rest } = response;
-    const { preview: responsePreview, length: responseLength } = truncateText(responseText);
+    const { headers, ...rest } = response;
     logger2.info("LLM call completed", {
       type: "llm_call_complete",
       span_id: spanId,
       service,
       method,
       ...rest,
-      responsePreview,
-      responseLength,
       ...pickHeaders(headers, LLM_RESPONSE_HEADER_ALLOWLIST),
       duration_ms: duration
     });
@@ -9509,170 +9498,6 @@ function requireNuaJsonSchemaValueValidation() {
 
 var httpLlmClient = {};
 
-var modelInfo = {};
-
-var hasRequiredModelInfo;
-function requireModelInfo() {
-  if (hasRequiredModelInfo) return modelInfo;
-  hasRequiredModelInfo = 1;
-  (function(exports$1) {
-    Object.defineProperty(exports$1, "__esModule", { value: true });
-    exports$1.SUPPORTED_MODELS = exports$1.CANONICAL_MODELS = void 0;
-    exports$1.parseCanonicalModelName = parseCanonicalModelName;
-    exports$1.CANONICAL_MODELS = [
-      "qwen3-30b-a3b-instruct-2507",
-      "claude-opus-4-7",
-      "claude-sonnet-4-6",
-      "claude-haiku-4-5",
-      "qwen3-vl-235b-a22b-instruct",
-      "qwen3-max",
-      "gpt-5",
-      "gemini-2.5-flash-lite",
-      "gemini-2.5-flash",
-      "qwen3-coder-flash",
-      "gpt-oss-120b",
-      "kimi-k2.5",
-      "kimi-k2.6"
-    ];
-    const CANONICAL_SET = new Set(exports$1.CANONICAL_MODELS);
-    exports$1.SUPPORTED_MODELS = {
-      "gpt-oss-120b": [
-        {
-          provider: "cerebras",
-          providerModelName: "gpt-oss-120b"
-        },
-        {
-          provider: "groq",
-          providerModelName: "openai/gpt-oss-120b"
-        },
-        {
-          provider: "openrouter",
-          providerModelName: "openai/gpt-oss-120b"
-        }
-      ],
-      "qwen3-30b-a3b-instruct-2507": [
-        {
-          provider: "openrouter",
-          providerModelName: "qwen/qwen3-30b-a3b-instruct-2507"
-        }
-      ],
-      "claude-opus-4-7": [
-        {
-          provider: "openrouter",
-          providerModelName: "anthropic/claude-opus-4.7"
-        }
-      ],
-      "claude-sonnet-4-6": [
-        {
-          provider: "openrouter",
-          providerModelName: "anthropic/claude-sonnet-4.6"
-        }
-      ],
-      "claude-haiku-4-5": [
-        {
-          provider: "openrouter",
-          providerModelName: "anthropic/claude-haiku-4.5"
-        }
-      ],
-      "qwen3-vl-235b-a22b-instruct": [
-        {
-          provider: "openrouter",
-          providerModelName: "qwen/qwen3-vl-235b-a22b-instruct"
-        }
-      ],
-      "qwen3-max": [
-        {
-          provider: "openrouter",
-          providerModelName: "qwen/qwen3-max"
-        }
-      ],
-      "gpt-5": [
-        {
-          provider: "openrouter",
-          providerModelName: "openai/gpt-5"
-        }
-      ],
-      "gemini-2.5-flash-lite": [
-        {
-          provider: "gemini",
-          providerModelName: "gemini-2.5-flash-lite"
-        },
-        {
-          provider: "openrouter",
-          providerModelName: "google/gemini-2.5-flash-lite"
-        }
-      ],
-      "gemini-2.5-flash": [
-        {
-          provider: "gemini",
-          providerModelName: "gemini-2.5-flash"
-        },
-        {
-          provider: "openrouter",
-          providerModelName: "google/gemini-2.5-flash"
-        }
-      ],
-      "qwen3-coder-flash": [
-        {
-          provider: "openrouter",
-          providerModelName: "qwen/qwen3-coder-flash"
-        }
-      ],
-      "kimi-k2.5": [
-        {
-          provider: "openrouter",
-          providerModelName: "moonshotai/kimi-k2.5"
-        }
-      ],
-      "kimi-k2.6": [
-        {
-          provider: "openrouter",
-          providerModelName: "moonshotai/kimi-k2.6"
-        }
-      ]
-    };
-    function parseCanonicalModelName(requestedModel) {
-      let m = requestedModel || "fast";
-      if (CANONICAL_SET.has(m))
-        return m;
-      let m2;
-      switch (m) {
-        case "fast":
-          m2 = "gpt-oss-120b";
-          break;
-        case "gemini":
-          m2 = "gemini-2.5-flash";
-          break;
-        case "qwen":
-          m2 = "qwen3-vl-235b-a22b-instruct";
-          break;
-        case "sonnet":
-          m2 = "claude-sonnet-4-6";
-          break;
-        case "opus":
-          m2 = "claude-opus-4-7";
-          break;
-        case "haiku":
-          m2 = "claude-haiku-4-5";
-          break;
-        case "kimi":
-          m2 = "kimi-k2.6";
-          break;
-        case "gpt":
-          m2 = "gpt-5";
-          break;
-      }
-      if (m2)
-        return m2;
-      return {
-        kind: "validation-error",
-        message: `Invalid model name: ${m ?? "null/undefined"}`
-      };
-    }
-  })(modelInfo);
-  return modelInfo;
-}
-
 var providerConfig = {};
 
 var hasRequiredProviderConfig;
@@ -9681,7 +9506,13 @@ function requireProviderConfig() {
   hasRequiredProviderConfig = 1;
   (function(exports$1) {
     Object.defineProperty(exports$1, "__esModule", { value: true });
-    exports$1.providerConfigs = exports$1.extractOpenAiMessageText = exports$1.normalizeGeminiUsage = exports$1.normalizeOpenAiUsage = exports$1.normalizedUsageZero = void 0;
+    exports$1.providerConfigs = exports$1.extractOpenAiMessageText = exports$1.normalizeGeminiUsage = exports$1.normalizeOpenAiUsage = exports$1.normalizedUsageZero = exports$1.LLM_PROVIDER_IDS = void 0;
+    exports$1.LLM_PROVIDER_IDS = [
+      "groq",
+      "cerebras",
+      "gemini",
+      "openrouter"
+    ];
     exports$1.normalizedUsageZero = {
       promptTokens: 0,
       completionTokens: 0,
@@ -10380,7 +10211,6 @@ function requireHttpLlmClient() {
   hasRequiredHttpLlmClient = 1;
   Object.defineProperty(httpLlmClient, "__esModule", { value: true });
   httpLlmClient.HttpLlmClient = void 0;
-  const model_info_1 = requireModelInfo();
   const logger_1 = requireLogger();
   const provider_config_1 = requireProviderConfig();
   const provider_formatters_1 = requireProviderFormatters();
@@ -10392,10 +10222,9 @@ function requireHttpLlmClient() {
     }
     async sendRequest(prompt, model, maxTokens, assistantPrefillPrompt) {
       const provider = this.getProviderConfig();
-      const providerModelName = this.getProviderModelName(model);
       const requestOptions = provider.buildRequest({
         prompt,
-        model: providerModelName,
+        model,
         maxTokens,
         assistantPrefillPrompt
       }, this.apiKey);
@@ -10406,18 +10235,17 @@ function requireHttpLlmClient() {
         apiOperation: provider.apiOperation,
         requestOptions,
         parseResponse: provider.parseResponse,
-        getResponsePreview: (parsedResponse) => parsedResponse.text,
+        getResponseLength: (parsedResponse) => parsedResponse.text.length,
         getUsage: (parsedResponse) => parsedResponse.usage
       });
     }
     async sendAgenticRequest(messages, tools, model, maxTokens, systemPrompt, onEvent) {
       const provider = this.getProviderConfig();
-      const providerModelName = this.getProviderModelName(model);
       const codec = this.getAgenticProviderCodec(provider.errorLabel);
       const requestOptions = codec.buildRequest({
         messages,
         tools,
-        model: providerModelName,
+        model,
         maxTokens,
         systemPrompt,
         stream: !!onEvent
@@ -10430,7 +10258,7 @@ function requireHttpLlmClient() {
         apiOperation: "agentic",
         requestOptions,
         parseResponse,
-        getResponsePreview: (parsedResponse) => parsedResponse.message.content.filter((content) => content.type === "text").map((content) => content.text).join(""),
+        getResponseLength: (parsedResponse) => parsedResponse.message.content.reduce((total, content) => total + (content.type === "text" ? content.text.length : 0), 0),
         getUsage: (parsedResponse) => parsedResponse.usage
       });
     }
@@ -10441,13 +10269,6 @@ function requireHttpLlmClient() {
       }
       return provider;
     }
-    getProviderModelName(model) {
-      const providerSpecificModelName = model_info_1.SUPPORTED_MODELS[model].find((pm) => pm.provider === this.providerId);
-      if (!providerSpecificModelName) {
-        throw new Error(`LLM Provider ${this.providerId} does not support model ${model}. If this is an error and the provider does support this model, please contact us to fix it`);
-      }
-      return providerSpecificModelName.providerModelName;
-    }
     async executeProviderCall(params) {
       const method = params.requestOptions.method ?? "POST";
       const headers = params.requestOptions.headers ?? {};
@@ -10470,7 +10291,7 @@ function requireHttpLlmClient() {
         const duration = Date.now() - startTime;
         (0, logger_1.logLlmCallComplete)(this.logger, spanId, params.provider.providerId, params.apiOperation, {
           status: response.status,
-          responseText: params.getResponsePreview(parsedResponse),
+          responseLength: params.getResponseLength(parsedResponse),
           headers: Object.fromEntries(response.headers.entries()),
           usage: params.getUsage(parsedResponse)
         }, duration);
@@ -10525,6 +10346,112 @@ function requireHttpLlmClient() {
   return httpLlmClient;
 }
 
+var modelInfo = {};
+
+var hasRequiredModelInfo;
+function requireModelInfo() {
+  if (hasRequiredModelInfo) return modelInfo;
+  hasRequiredModelInfo = 1;
+  (function(exports$1) {
+    Object.defineProperty(exports$1, "__esModule", { value: true });
+    exports$1.MODEL_ALIAS_NAMES = exports$1.MODEL_ALIASES = void 0;
+    exports$1.isLlmProviderId = isLlmProviderId;
+    exports$1.isModelAliasName = isModelAliasName;
+    exports$1.resolveModelInput = resolveModelInput;
+    const provider_config_1 = requireProviderConfig();
+    exports$1.MODEL_ALIASES = {
+      fast: [
+        { provider: "cerebras", model: "gpt-oss-120b" },
+        { provider: "groq", model: "openai/gpt-oss-120b" },
+        { provider: "openrouter", model: "openai/gpt-oss-120b" }
+      ],
+      gemini: [
+        { provider: "gemini", model: "gemini-2.5-flash" },
+        { provider: "openrouter", model: "google/gemini-2.5-flash" }
+      ],
+      qwen: [
+        { provider: "openrouter", model: "qwen/qwen3-vl-235b-a22b-instruct" }
+      ],
+      sonnet: [
+        { provider: "openrouter", model: "anthropic/claude-sonnet-4.6" }
+      ],
+      opus: [
+        { provider: "openrouter", model: "anthropic/claude-opus-4.7" }
+      ],
+      haiku: [
+        { provider: "openrouter", model: "anthropic/claude-haiku-4.5" }
+      ],
+      kimi: [
+        { provider: "openrouter", model: "moonshotai/kimi-k2.6" }
+      ],
+      gpt: [
+        { provider: "openrouter", model: "openai/gpt-5" }
+      ]
+    };
+    exports$1.MODEL_ALIAS_NAMES = Object.keys(exports$1.MODEL_ALIASES);
+    const MODEL_ALIAS_SET = new Set(exports$1.MODEL_ALIAS_NAMES);
+    const LLM_PROVIDER_ID_SET = new Set(provider_config_1.LLM_PROVIDER_IDS);
+    function isLlmProviderId(value) {
+      return typeof value === "string" && LLM_PROVIDER_ID_SET.has(value);
+    }
+    function isModelAliasName(value) {
+      return typeof value === "string" && MODEL_ALIAS_SET.has(value);
+    }
+    function validationError(message) {
+      return {
+        kind: "validation-error",
+        message
+      };
+    }
+    function validateProviderModel(input, configuredProviders) {
+      if (!isLlmProviderId(input.provider)) {
+        return validationError(`Invalid LLM provider: ${String(input.provider)}`);
+      }
+      if (!configuredProviders.has(input.provider)) {
+        return validationError(`LLM provider ${input.provider} is not configured. Please check your API keys.`);
+      }
+      if (typeof input.model !== "string") {
+        return validationError("model.model must be a string");
+      }
+      const model = input.model.trim();
+      if (!model) {
+        return validationError("model.model must be a non-empty string");
+      }
+      if (input.provider === "gemini" && model.startsWith("models/")) {
+        return validationError('Gemini model names must use bare model IDs, for example "gemini-2.5-flash", not "models/gemini-2.5-flash".');
+      }
+      return {
+        provider: input.provider,
+        model
+      };
+    }
+    function resolveModelInput(input, configuredProviders) {
+      if (input == null) {
+        return resolveModelInput({ alias: "fast" }, configuredProviders);
+      }
+      if (typeof input !== "object") {
+        return validationError("model must be an object with either alias or provider/model fields");
+      }
+      if ("provider" in input || "model" in input) {
+        return validateProviderModel(input, configuredProviders);
+      }
+      if ("alias" in input) {
+        const alias = input.alias;
+        if (!isModelAliasName(alias)) {
+          return validationError(`Invalid model alias: ${String(alias)}`);
+        }
+        const configuredTarget = exports$1.MODEL_ALIASES[alias].find((target) => configuredProviders.has(target.provider));
+        if (!configuredTarget) {
+          return validationError(`No configured provider found for model alias ${alias}. Please check your API keys.`);
+        }
+        return configuredTarget;
+      }
+      return validationError("model must include either alias or provider/model fields");
+    }
+  })(modelInfo);
+  return modelInfo;
+}
+
 var castArrayPromptBuilder = {};
 
 var promptTemplateUtils = {};
@@ -10827,28 +10754,26 @@ function requireNuaLlmClient() {
         }
       });
     }
-    getClientForModel(model) {
-      const supported = model_info_1.SUPPORTED_MODELS[model];
-      if (!supported || supported.length === 0) {
-        throw new Error(`Model ${model} is not supported or configuration is missing.`);
-      }
-      for (const option of supported) {
-        if (this.clients.has(option.provider)) {
-          return this.clients.get(option.provider);
-        }
-      }
-      throw new Error(`No configured provider found for model ${model}. Please check your API keys.`);
+    getConfiguredProviderIds() {
+      return new Set(this.clients.keys());
     }
-    resolveModel(modelName) {
-      const result = (0, model_info_1.parseCanonicalModelName)(modelName);
+    resolveModel(model) {
+      const result = (0, model_info_1.resolveModelInput)(model, this.getConfiguredProviderIds());
       if ((0, nua_errors_1.isNuaValidationError)(result)) {
         throw new Error(result.message);
       }
       return result;
     }
+    getClientForProvider(provider) {
+      const client = this.clients.get(provider);
+      if (!client) {
+        throw new Error(`LLM provider ${provider} is not configured. Please check your API keys.`);
+      }
+      return client;
+    }
     async castValue(params) {
-      const model = this.resolveModel(params.model);
-      const client = this.getClientForModel(model);
+      const providerModel = this.resolveModel(params.model);
+      const client = this.getClientForProvider(providerModel.provider);
       const maxTokens = params.maxTokens || 4096;
       const temperature = params.temperature ?? 0;
       const prompt = cast_prompt_builder_1.default.buildFullPrompt(params);
@@ -10857,7 +10782,7 @@ function requireNuaLlmClient() {
         const result = await (0, call_llm_service_1.callLLM)(
           client,
           prompt,
-          model,
+          providerModel.model,
           maxTokens,
           temperature,
           3,
@@ -10879,8 +10804,8 @@ function requireNuaLlmClient() {
       }
     }
     async castArray(params) {
-      const model = this.resolveModel(params.model);
-      const client = this.getClientForModel(model);
+      const providerModel = this.resolveModel(params.model);
+      const client = this.getClientForProvider(providerModel.provider);
       const maxTokens = params.maxTokens || 4096;
       const temperature = params.temperature ?? 0;
       const validData = (0, validate_mappable_input_data_1.validateMappableInputData)(params.data, params.input.primaryKey);
@@ -10893,7 +10818,7 @@ function requireNuaLlmClient() {
       const prompt = cast_array_prompt_builder_1.default.buildFullPrompt(params, validData);
       const validationFn = (0, nua_json_schema_value_validation_1.buildNuaJsonSchemaValueValidation)("library-req", params.output.effectiveSchema);
       try {
-        const result = await (0, call_llm_service_1.callLLM)(client, prompt, model, maxTokens, temperature, 3, validationFn);
+        const result = await (0, call_llm_service_1.callLLM)(client, prompt, providerModel.model, maxTokens, temperature, 3, validationFn);
         return {
           success: true,
           data: result.data,
@@ -10910,8 +10835,8 @@ function requireNuaLlmClient() {
     }
     async runAgent(params) {
       try {
-        const model = this.resolveModel(params.model);
-        const client = this.getClientForModel(model);
+        const providerModel = this.resolveModel(params.model);
+        const client = this.getClientForProvider(providerModel.provider);
         const maxTokens = params.maxTokens ?? 4096;
         const maxTurns = params.maxTurns ?? 10;
         return (0, agent_loop_1.runAgentLoop)({
@@ -10920,7 +10845,7 @@ function requireNuaLlmClient() {
           systemPrompt: params.systemPrompt,
           maxTurns,
           onEvent: params.onEvent,
-          sendRequest: (messages, tools, systemPrompt) => client.sendAgenticRequest(messages, tools, model, maxTokens, systemPrompt, params.onEvent)
+          sendRequest: (messages, tools, systemPrompt) => client.sendAgenticRequest(messages, tools, providerModel.model, maxTokens, systemPrompt, params.onEvent)
         });
       } catch (e) {
         return {
@@ -11105,7 +11030,7 @@ function requireDist() {
       return mod && mod.__esModule ? mod : { "default": mod };
     };
     Object.defineProperty(exports$1, "__esModule", { value: true });
-    exports$1.runAgentLoop = exports$1.stableStringify = exports$1.validateJsonSchema = exports$1.providerConfigs = exports$1.normalizedUsageZero = exports$1.castArrayPromptBuilder = exports$1.castPromptBuilder = void 0;
+    exports$1.runAgentLoop = exports$1.stableStringify = exports$1.validateJsonSchema = exports$1.providerConfigs = exports$1.normalizedUsageZero = exports$1.LLM_PROVIDER_IDS = exports$1.castArrayPromptBuilder = exports$1.castPromptBuilder = void 0;
     __exportStar(requireNuaLlmClient(), exports$1);
     __exportStar(requireLogger(), exports$1);
     __exportStar(requireTypes(), exports$1);
@@ -11119,6 +11044,9 @@ function requireDist() {
       return __importDefault(cast_array_prompt_builder_1).default;
     } });
     var provider_config_1 = requireProviderConfig();
+    Object.defineProperty(exports$1, "LLM_PROVIDER_IDS", { enumerable: true, get: function() {
+      return provider_config_1.LLM_PROVIDER_IDS;
+    } });
     Object.defineProperty(exports$1, "normalizedUsageZero", { enumerable: true, get: function() {
       return provider_config_1.normalizedUsageZero;
     } });
@@ -11152,9 +11080,6 @@ const normalizedUsageZero = {
 };
 class DirectBackend {
   constructor(config) {
-    if (!config.model) {
-      throw new Error("model is required for direct mode");
-    }
     this.model = config.model;
     this.client = new distExports.NuaLlmClient({ providers: config.providers });
   }
@@ -11179,7 +11104,7 @@ class DirectBackend {
       success: true,
       data: result.data,
       usage: result.usage || normalizedUsageZero,
-      model,
+      model: formatModelInput(model),
       latencyMs,
       source: "direct",
       meta: {}
@@ -11211,13 +11136,18 @@ class DirectBackend {
       success: true,
       data: result.data,
       usage: result.usage || normalizedUsageZero,
-      model,
+      model: formatModelInput(model),
       latencyMs,
       source: "direct",
       meta: {}
     };
   }
 }
+function formatModelInput(model) {
+  if (!model) return "fast";
+  if ("alias" in model) return model.alias;
+  return `${model.provider}:${model.model}`;
+}
 
 function resolveConfigValue(config, key, envVar) {
   if (config[key]) return config[key];

package/dist/types/backend/direct.d.ts

@@ -1,7 +1,7 @@
 import { CastArrayParams, CastResult, CastValueParams, LlmBackend } from './types';
-import { LlmProviderId } from 'nua-llm-core';
+import type { LlmProviderId, ModelInput } from 'nua-llm-core';
 export type DirectConfig = {
-    model: string;
+    model?: ModelInput;
     providers: {
         [key in LlmProviderId]?: {
             apiKey: string;

package/dist/types/backend/types.d.ts

@@ -1,9 +1,10 @@
+import type { ModelInput } from 'nua-llm-core';
 export type CastValueParams = {
     prompt: string;
     data: unknown;
     outputName: string;
     outputSchema: object;
-    model?: string;
+    model?: ModelInput;
 };
 export type CastArrayParams = {
     prompt: string;
@@ -11,7 +12,7 @@ export type CastArrayParams = {
     primaryKey: string;
     outputName: string;
     outputSchema: object;
-    model?: string;
+    model?: ModelInput;
 };
 export type NormalizedUsage = {
     promptTokens: number;

package/dist/types/nua.d.ts

@@ -1,6 +1,7 @@
 import { DirectConfig } from './backend/direct';
 import { GatewayConfig } from './backend/gateway';
 import { CastResult, QueueResult } from './backend/types';
+import type { ModelInput } from 'nua-llm-core';
 import { z } from 'zod';
 export type OutputDef<TSchema extends z.ZodTypeAny> = {
     name: string;
@@ -9,13 +10,13 @@ export type OutputDef<TSchema extends z.ZodTypeAny> = {
 export type GetOptions<TSchema extends z.ZodTypeAny> = {
     input?: unknown;
     output: OutputDef<TSchema>;
-    model?: string;
+    model?: ModelInput;
 };
 export type ListOptions<TSchema extends z.ZodTypeAny, TData extends Record<string, unknown>, PrimaryKey extends keyof TData & string> = {
     input: TData[];
     primaryKey: PrimaryKey;
     output: OutputDef<TSchema>;
-    model?: string;
+    model?: ModelInput;
 };
 export type ListResultRow<TSchema extends z.ZodTypeAny, PrimaryKey extends string> = {
     [K in PrimaryKey]: string | number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nuabase",
   "description": "Nuabase TypeScript client to create typed functions from LLM prompts",
-  "version": "2.3.3",
+  "version": "2.3.4",
   "type": "module",
   "author": "Jasim A Basheer <jasim@nuabase.com>",
   "engines": {