@stacksjs/ai 0.70.254 → 0.70.256

package/dist/client.d.ts

@@ -1,4 +1,10 @@
-import type { AIProvider, ConfiguredAIClient, ConfiguredAIOptions } from './types';
+import type { AIProvider, AIProviderConfiguration, ConfiguredAIClient, ConfiguredAIOptions } from './types';
+export declare function resolveAIProvider(config: ConfiguredAIOptions, override?: AIProvider): AIProvider;
+/**
+ * Inspect the selected provider without creating a request or exposing secrets.
+ * Applications can use this for health checks, settings screens, and fallbacks.
+ */
+export declare function getAIProviderConfiguration(config: ConfiguredAIOptions, override?: AIProvider, environment?: Record<string, string | undefined>): AIProviderConfiguration;
 declare function parseObject(content: string): unknown;
 declare function validateSchema(value: unknown, schema: Record<string, any>, path?: string): string[];
 /**

package/dist/client.js

@@ -7,7 +7,7 @@ function textContent(content) {
   return content.filter((block) => block.type === "text").map((block) => block.text ?? "").join(`
 `);
 }
-function providerFromConfig(config, override) {
+export function resolveAIProvider(config, override) {
   if (override)
     return override;
   const configured = String(config.default || "").toLowerCase();
@@ -19,6 +19,27 @@ function providerFromConfig(config, override) {
     return "ollama";
   throw Error(`Unsupported configured AI driver: ${config.default || "(empty)"}. Expected anthropic, openai, or ollama.`);
 }
+function configuredModel(config, provider) {
+  const driverModel = config.drivers?.[provider]?.model?.trim();
+  if (driverModel)
+    return driverModel;
+  const configuredDefault = String(config.default || "").trim();
+  if (!configuredDefault || configuredDefault.toLowerCase() === provider)
+    return;
+  return configuredDefault;
+}
+export function getAIProviderConfiguration(config, override, environment = process.env) {
+  const provider = resolveAIProvider(config, override), driver = config.drivers?.[provider] ?? {}, model = configuredModel(config, provider);
+  if (provider === "ollama")
+    return { provider, model, configured: !0, source: "local" };
+  if (driver.apiKey?.trim())
+    return { provider, model, configured: !0, source: "config" };
+  if (environment[provider === "openai" ? "OPENAI_API_KEY" : "ANTHROPIC_API_KEY"]?.trim())
+    return { provider, model, configured: !0, source: "environment" };
+  if (driver.baseUrl?.trim())
+    return { provider, model, configured: !0, source: "base-url" };
+  return { provider, model, configured: !1, source: "none" };
+}
 function parseObject(content) {
   const unfenced = content.trim().replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/, "");
   try {
@@ -132,9 +153,10 @@ function createGenerate(config, provider) {
   };
 }
 export function createAIClient(config, override) {
-  const provider = providerFromConfig(config, override), generate = createGenerate(config, provider);
+  const provider = resolveAIProvider(config, override), configuration = getAIProviderConfiguration(config, provider), generate = createGenerate(config, provider);
   return {
     provider,
+    configuration,
     generate,
     async generateObject(messages, schema, options = {}) {
       const { attempts = 2, system, ...completionOptions } = options, history = [...messages];

package/dist/types.d.ts

@@ -168,6 +168,16 @@ export declare interface AIConfig {
   search?: SearchConfig
   mcp?: MCPConfig
 }
+/**
+ * Safe, provider-neutral configuration metadata for diagnostics and UI.
+ * Never includes credentials.
+ */
+export declare interface AIProviderConfiguration {
+  provider: AIProvider
+  model?: string
+  configured: boolean
+  source: AIConfigurationSource
+}
 export declare interface ConfiguredAIOptions extends AIConfig {
   drivers?: {
     anthropic?: AIDriverConfig & { anthropicVersion?: string }
@@ -181,6 +191,7 @@ export declare interface GenerateObjectOptions extends ChatCompletionOptions {
 }
 export declare interface ConfiguredAIClient {
   provider: AIProvider
+  configuration: AIProviderConfiguration
   generate: (messages: AIMessage[], options?: ChatCompletionOptions & { system?: string }) => Promise<AIResult>
   generateObject: <T>(
     messages: AIMessage[],
@@ -204,3 +215,4 @@ export type AIResponseFormat = | { type: 'text' }
       }
     }
 export type AIProvider = 'anthropic' | 'openai' | 'ollama';
+export type AIConfigurationSource = 'config' | 'environment' | 'base-url' | 'local' | 'none';

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/ai",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.254",
+  "version": "0.70.256",
   "description": "Stacks Artificial Intelligence.",
   "author": "Chris Breuer",
   "contributors": [