@dexto/agent-management 1.3.0 → 1.5.0

package/dist/preferences/loader.d.ts

@@ -23,12 +23,31 @@ export declare function globalPreferencesExist(): boolean;
  * @returns Absolute path to preferences.yml
  */
 export declare function getGlobalPreferencesPath(): string;
+/**
+ * Options for creating initial preferences
+ */
+export interface CreatePreferencesOptions {
+    provider: LLMProvider;
+    model: string;
+    /** API key env var (optional for providers like Ollama that don't need auth) */
+    apiKeyVar?: string;
+    defaultAgent?: string;
+    defaultMode?: 'cli' | 'web' | 'server' | 'discord' | 'telegram' | 'mcp';
+    baseURL?: string;
+    setupCompleted?: boolean;
+    /** Whether API key setup was skipped and needs to be configured later */
+    apiKeyPending?: boolean;
+    /** Whether baseURL setup was skipped and needs to be configured later */
+    baseURLPending?: boolean;
+}
 /**
  * Create initial preferences from setup data
- * @param provider Selected LLM provider
- * @param model Selected model
- * @param apiKeyVar Environment variable name for API key
- * @param defaultAgent Optional default agent name
+ * @param options Configuration options for preferences
+ */
+export declare function createInitialPreferences(options: CreatePreferencesOptions): GlobalPreferences;
+/**
+ * Create initial preferences from setup data (legacy signature)
+ * @deprecated Use options object instead
  */
 export declare function createInitialPreferences(provider: LLMProvider, model: string, apiKeyVar: string, defaultAgent?: string): GlobalPreferences;
 /**

package/dist/preferences/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/preferences/loader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAI/E;;;;;GAKG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CA+BxE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCzF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,YAAY,GAAE,MAAwB,GACvC,iBAAiB,CAenB;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACnC,GAAG,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;CAC/C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,wBAAwB,GAClC,OAAO,CAAC,iBAAiB,CAAC,CA2B5B"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/preferences/loader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAI/E;;;;;GAKG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CA+BxE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCzF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAAC;AAE/F;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACtB,iBAAiB,CAAC;AA2DrB;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACnC,GAAG,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;CAC/C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,wBAAwB,GAClC,OAAO,CAAC,iBAAiB,CAAC,CA2B5B"}

package/dist/preferences/loader.js

@@ -38,7 +38,7 @@ async function saveGlobalPreferences(preferences) {
     throw PreferenceError.validationFailed(validation.error);
   }
   try {
-    logger.info(`Saving global preferences to: ${preferencesPath}`);
+    logger.debug(`Saving global preferences to: ${preferencesPath}`);
     const dextoDir = getDextoGlobalPath("");
     await fs.mkdir(dextoDir, { recursive: true });
     const yamlContent = stringifyYaml(preferences, {
@@ -47,7 +47,7 @@ async function saveGlobalPreferences(preferences) {
       minContentWidth: 20
     });
     await fs.writeFile(preferencesPath, yamlContent, "utf-8");
-    logger.info(
+    logger.debug(
       `\u2713 Saved global preferences ${JSON.stringify(preferences)} to: ${preferencesPath}`
     );
   } catch (error) {
@@ -64,20 +64,46 @@ function globalPreferencesExist() {
 function getGlobalPreferencesPath() {
   return getDextoGlobalPath(PREFERENCES_FILE);
 }
-function createInitialPreferences(provider, model, apiKeyVar, defaultAgent = "default-agent") {
+function createInitialPreferences(providerOrOptions, model, apiKeyVar, defaultAgent = "coding-agent") {
+  if (typeof providerOrOptions === "object") {
+    const opts = providerOrOptions;
+    const llmConfig = {
+      provider: opts.provider,
+      model: opts.model
+    };
+    if (opts.apiKeyVar) {
+      llmConfig.apiKey = `$${opts.apiKeyVar}`;
+    }
+    if (opts.baseURL) {
+      llmConfig.baseURL = opts.baseURL;
+    }
+    return {
+      llm: llmConfig,
+      defaults: {
+        defaultAgent: opts.defaultAgent || "coding-agent",
+        defaultMode: opts.defaultMode || "web"
+      },
+      setup: {
+        completed: opts.setupCompleted ?? true,
+        apiKeyPending: opts.apiKeyPending ?? false,
+        baseURLPending: opts.baseURLPending ?? false
+      }
+    };
+  }
   return {
     llm: {
-      provider,
+      provider: providerOrOptions,
       model,
       apiKey: `$${apiKeyVar}`
     },
     defaults: {
       defaultAgent,
       defaultMode: "web"
-      // Default to web mode
     },
     setup: {
-      completed: true
+      completed: true,
+      apiKeyPending: false,
+      baseURLPending: false
     }
   };
 }

package/dist/preferences/schemas.cjs

@@ -36,9 +36,13 @@ const PreferenceLLMSchema = import_zod.z.object({
   apiKey: import_zod.z.string().regex(
     /^\$[A-Z_][A-Z0-9_]*$/,
     "Must be environment variable reference (e.g., $OPENAI_API_KEY)"
-  ).describe("Environment variable reference for API key")
+  ).optional().describe(
+    "Environment variable reference for API key (optional for local providers like Ollama)"
+  ),
+  baseURL: import_zod.z.string().url("Must be a valid URL (e.g., http://localhost:11434/v1)").optional().describe("Custom base URL for providers that support it (openai-compatible, litellm)")
 }).strict().superRefine((data, ctx) => {
-  if (!(0, import_core.isValidProviderModel)(data.provider, data.model)) {
+  const skipModelValidation = (0, import_core.acceptsAnyModel)(data.provider) || (0, import_core.supportsCustomModels)(data.provider);
+  if (!skipModelValidation && !(0, import_core.isValidProviderModel)(data.provider, data.model)) {
     const supportedModels = (0, import_core.getSupportedModels)(data.provider);
     ctx.addIssue({
       code: import_zod.z.ZodIssueCode.custom,
@@ -51,13 +55,27 @@ const PreferenceLLMSchema = import_zod.z.object({
       }
     });
   }
+  if (data.baseURL && !(0, import_core.supportsBaseURL)(data.provider)) {
+    ctx.addIssue({
+      code: import_zod.z.ZodIssueCode.custom,
+      path: ["baseURL"],
+      message: `Provider '${data.provider}' does not support custom baseURL. Use 'openai-compatible' for custom endpoints.`,
+      params: {
+        code: import_error_codes.PreferenceErrorCode.INVALID_PREFERENCE_VALUE,
+        scope: "preference",
+        type: import_core4.ErrorType.USER
+      }
+    });
+  }
 });
 const PreferenceDefaultsSchema = import_zod.z.object({
   defaultAgent: import_zod.z.string().min(1).describe("Default agent name for global CLI usage (required)"),
   defaultMode: import_zod.z.enum(["cli", "web", "server", "discord", "telegram", "mcp"]).default("web").describe("Default run mode when --mode flag is not specified (default: web)")
 }).strict();
 const PreferenceSetupSchema = import_zod.z.object({
-  completed: import_zod.z.boolean().default(false).describe("Whether initial setup has been completed")
+  completed: import_zod.z.boolean().default(false).describe("Whether initial setup has been completed"),
+  apiKeyPending: import_zod.z.boolean().default(false).describe("Whether API key setup was skipped and needs to be configured later"),
+  baseURLPending: import_zod.z.boolean().default(false).describe("Whether baseURL setup was skipped and needs to be configured later")
 }).strict();
 const GlobalPreferencesSchema = import_zod.z.object({
   llm: PreferenceLLMSchema.describe("LLM configuration preferences"),

package/dist/preferences/schemas.d.ts

@@ -1,24 +1,29 @@
 import { z } from 'zod';
 export declare const PreferenceLLMSchema: z.ZodEffects<z.ZodObject<{
-    provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere"]>;
+    provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere", "openrouter", "litellm", "glama", "vertex", "bedrock", "local", "ollama"]>;
     model: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
-    apiKey: z.ZodString;
+    apiKey: z.ZodOptional<z.ZodString>;
+    baseURL: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
     model: string;
-    apiKey: string;
+    apiKey?: string | undefined;
+    baseURL?: string | undefined;
 }, {
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
     model: string;
-    apiKey: string;
+    apiKey?: string | undefined;
+    baseURL?: string | undefined;
 }>, {
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
     model: string;
-    apiKey: string;
+    apiKey?: string | undefined;
+    baseURL?: string | undefined;
 }, {
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
     model: string;
-    apiKey: string;
+    apiKey?: string | undefined;
+    baseURL?: string | undefined;
 }>;
 export declare const PreferenceDefaultsSchema: z.ZodObject<{
     defaultAgent: z.ZodString;
@@ -32,32 +37,43 @@ export declare const PreferenceDefaultsSchema: z.ZodObject<{
 }>;
 export declare const PreferenceSetupSchema: z.ZodObject<{
     completed: z.ZodDefault<z.ZodBoolean>;
+    apiKeyPending: z.ZodDefault<z.ZodBoolean>;
+    baseURLPending: z.ZodDefault<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     completed: boolean;
+    apiKeyPending: boolean;
+    baseURLPending: boolean;
 }, {
     completed?: boolean | undefined;
+    apiKeyPending?: boolean | undefined;
+    baseURLPending?: boolean | undefined;
 }>;
 export declare const GlobalPreferencesSchema: z.ZodObject<{
     llm: z.ZodEffects<z.ZodObject<{
-        provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere"]>;
+        provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere", "openrouter", "litellm", "glama", "vertex", "bedrock", "local", "ollama"]>;
         model: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
-        apiKey: z.ZodString;
+        apiKey: z.ZodOptional<z.ZodString>;
+        baseURL: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
-        apiKey: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
     }, {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
-        apiKey: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
     }>, {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
-        apiKey: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
     }, {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
-        apiKey: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
     }>;
     defaults: z.ZodObject<{
         defaultAgent: z.ZodString;
@@ -71,16 +87,23 @@ export declare const GlobalPreferencesSchema: z.ZodObject<{
     }>;
     setup: z.ZodDefault<z.ZodObject<{
         completed: z.ZodDefault<z.ZodBoolean>;
+        apiKeyPending: z.ZodDefault<z.ZodBoolean>;
+        baseURLPending: z.ZodDefault<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         completed: boolean;
+        apiKeyPending: boolean;
+        baseURLPending: boolean;
     }, {
         completed?: boolean | undefined;
+        apiKeyPending?: boolean | undefined;
+        baseURLPending?: boolean | undefined;
     }>>;
 }, "strict", z.ZodTypeAny, {
     llm: {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
-        apiKey: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
     };
     defaults: {
         defaultAgent: string;
@@ -88,12 +111,15 @@ export declare const GlobalPreferencesSchema: z.ZodObject<{
     };
     setup: {
         completed: boolean;
+        apiKeyPending: boolean;
+        baseURLPending: boolean;
     };
 }, {
     llm: {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
-        apiKey: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
     };
     defaults: {
         defaultAgent: string;
@@ -101,6 +127,8 @@ export declare const GlobalPreferencesSchema: z.ZodObject<{
     };
     setup?: {
         completed?: boolean | undefined;
+        apiKeyPending?: boolean | undefined;
+        baseURLPending?: boolean | undefined;
     } | undefined;
 }>;
 export type PreferenceLLM = z.output<typeof PreferenceLLMSchema>;

package/dist/preferences/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/preferences/schemas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;EA6B1B,CAAC;AAEP,eAAO,MAAM,wBAAwB;;;;;;;;;EAYxB,CAAC;AAEd,eAAO,MAAM,qBAAqB;;;;;;EAIrB,CAAC;AAEd,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUvB,CAAC;AAGd,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC3E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACrE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/preferences/schemas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;EA+D1B,CAAC;AAEP,eAAO,MAAM,wBAAwB;;;;;;;;;EAYxB,CAAC;AAEd,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAYrB,CAAC;AAEd,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUvB,CAAC;AAGd,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC3E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACrE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/preferences/schemas.js

@@ -1,5 +1,11 @@
 import { z } from "zod";
-import { isValidProviderModel, getSupportedModels } from "@dexto/core";
+import {
+  isValidProviderModel,
+  getSupportedModels,
+  acceptsAnyModel,
+  supportsCustomModels,
+  supportsBaseURL
+} from "@dexto/core";
 import { LLM_PROVIDERS } from "@dexto/core";
 import { NonEmptyTrimmed } from "@dexto/core";
 import { PreferenceErrorCode } from "./error-codes.js";
@@ -10,9 +16,13 @@ const PreferenceLLMSchema = z.object({
   apiKey: z.string().regex(
     /^\$[A-Z_][A-Z0-9_]*$/,
     "Must be environment variable reference (e.g., $OPENAI_API_KEY)"
-  ).describe("Environment variable reference for API key")
+  ).optional().describe(
+    "Environment variable reference for API key (optional for local providers like Ollama)"
+  ),
+  baseURL: z.string().url("Must be a valid URL (e.g., http://localhost:11434/v1)").optional().describe("Custom base URL for providers that support it (openai-compatible, litellm)")
 }).strict().superRefine((data, ctx) => {
-  if (!isValidProviderModel(data.provider, data.model)) {
+  const skipModelValidation = acceptsAnyModel(data.provider) || supportsCustomModels(data.provider);
+  if (!skipModelValidation && !isValidProviderModel(data.provider, data.model)) {
     const supportedModels = getSupportedModels(data.provider);
     ctx.addIssue({
       code: z.ZodIssueCode.custom,
@@ -25,13 +35,27 @@ const PreferenceLLMSchema = z.object({
       }
     });
   }
+  if (data.baseURL && !supportsBaseURL(data.provider)) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ["baseURL"],
+      message: `Provider '${data.provider}' does not support custom baseURL. Use 'openai-compatible' for custom endpoints.`,
+      params: {
+        code: PreferenceErrorCode.INVALID_PREFERENCE_VALUE,
+        scope: "preference",
+        type: ErrorType.USER
+      }
+    });
+  }
 });
 const PreferenceDefaultsSchema = z.object({
   defaultAgent: z.string().min(1).describe("Default agent name for global CLI usage (required)"),
   defaultMode: z.enum(["cli", "web", "server", "discord", "telegram", "mcp"]).default("web").describe("Default run mode when --mode flag is not specified (default: web)")
 }).strict();
 const PreferenceSetupSchema = z.object({
-  completed: z.boolean().default(false).describe("Whether initial setup has been completed")
+  completed: z.boolean().default(false).describe("Whether initial setup has been completed"),
+  apiKeyPending: z.boolean().default(false).describe("Whether API key setup was skipped and needs to be configured later"),
+  baseURLPending: z.boolean().default(false).describe("Whether baseURL setup was skipped and needs to be configured later")
 }).strict();
 const GlobalPreferencesSchema = z.object({
   llm: PreferenceLLMSchema.describe("LLM configuration preferences"),

package/dist/registry/registry.cjs

@@ -29,7 +29,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var registry_exports = {};
 __export(registry_exports, {
   LocalAgentRegistry: () => LocalAgentRegistry,
-  getAgentRegistry: () => getAgentRegistry
+  getAgentRegistry: () => getAgentRegistry,
+  loadBundledRegistryAgents: () => loadBundledRegistryAgents
 });
 module.exports = __toCommonJS(registry_exports);
 var import_fs = require("fs");
@@ -37,11 +38,10 @@ var import_fs2 = require("fs");
 var import_path = __toESM(require("path"), 1);
 var import_core = require("@dexto/core");
 var import_path2 = require("../utils/path.js");
-var import_loader = require("../preferences/loader.js");
-var import_writer = require("../writer.js");
 var import_types = require("./types.js");
 var import_errors = require("./errors.js");
 var import_user_registry = require("./user-registry.js");
+var import_loader = require("../preferences/loader.js");
 let cachedRegistry = null;
 class LocalAgentRegistry {
   _registry = null;
@@ -167,12 +167,15 @@ class LocalAgentRegistry {
       return configPath;
     }
   }
+  // TODO: Consider removing install/uninstall methods from LocalAgentRegistry class.
+  // Installing/uninstalling from registry to local agents/ is better suited as a CLI command.
+  // A bundler/opinionated project structure should help - agents/ will by default be their registry.
+  // For now these methods remain for backward compatibility.
   /**
    * Install agent atomically using temp + rename pattern
    * @param agentId ID of the agent to install
-   * @param injectPreferences Whether to inject global preferences into installed agent (default: true)
    */
-  async installAgent(agentId, injectPreferences = true) {
+  async installAgent(agentId) {
     import_core.logger.info(`Installing agent: ${agentId}`);
     const registry = this.getRegistry();
     const agentData = registry.agents[agentId];
@@ -210,24 +213,6 @@ class LocalAgentRegistry {
       }
       await import_fs2.promises.rename(tempDir, targetDir);
       import_core.logger.info(`\u2713 Installed agent '${agentId}' to ${targetDir}`);
-      if (injectPreferences) {
-        try {
-          const preferences = await (0, import_loader.loadGlobalPreferences)();
-          await (0, import_writer.writePreferencesToAgent)(targetDir, preferences);
-          import_core.logger.info(`\u2713 Applied global preferences to installed agent '${agentId}'`);
-        } catch (error) {
-          import_core.logger.warn(
-            `Failed to inject preferences to '${agentId}': ${error instanceof Error ? error.message : String(error)}`
-          );
-          console.log(
-            `\u26A0\uFE0F  Warning: Could not apply preferences to '${agentId}' - agent will use bundled settings`
-          );
-        }
-      } else {
-        import_core.logger.info(
-          `Skipped preference injection for '${agentId}' (injectPreferences=false)`
-        );
-      }
       return this.resolveMainConfig(targetDir, agentId);
     } catch (error) {
       try {
@@ -250,10 +235,9 @@ class LocalAgentRegistry {
    * @param agentId Unique identifier for the custom agent
    * @param sourcePath Absolute path to agent YAML file or directory
    * @param metadata Agent metadata (name for display, description, author, tags, main)
-   * @param injectPreferences Whether to inject global preferences (default: true)
    * @returns Path to the installed agent's main config file
    */
-  async installCustomAgentFromPath(agentId, sourcePath, metadata, injectPreferences = true) {
+  async installCustomAgentFromPath(agentId, sourcePath, metadata) {
     import_core.logger.info(`Installing custom agent '${agentId}' from ${sourcePath}`);
     this.validateCustomAgentId(agentId);
     if (!(0, import_fs.existsSync)(sourcePath)) {
@@ -327,20 +311,6 @@ class LocalAgentRegistry {
         }
         throw registryError;
       }
-      if (injectPreferences) {
-        try {
-          const preferences = await (0, import_loader.loadGlobalPreferences)();
-          await (0, import_writer.writePreferencesToAgent)(targetDir, preferences);
-          import_core.logger.info(`\u2713 Applied global preferences to custom agent '${agentId}'`);
-        } catch (error) {
-          import_core.logger.warn(
-            `Failed to inject preferences to '${agentId}': ${error instanceof Error ? error.message : String(error)}`
-          );
-          console.log(
-            `\u26A0\uFE0F  Warning: Could not apply preferences to '${agentId}' - agent will use default settings`
-          );
-        }
-      }
       return mainConfigPath;
     } catch (error) {
       try {
@@ -364,9 +334,8 @@ class LocalAgentRegistry {
    * Handles installing agent if needed
    * @param agentId ID of the agent to resolve
    * @param autoInstall Whether to automatically install missing agents from registry (default: true)
-   * @param injectPreferences Whether to inject preferences during auto-installation (default: true)
    */
-  async resolveAgent(agentId, autoInstall = true, injectPreferences = true) {
+  async resolveAgent(agentId, autoInstall = true) {
     import_core.logger.debug(`Resolving registry agent: ${agentId}`);
     const globalAgentsDir = (0, import_path2.getDextoGlobalPath)("agents");
     const installedPath = import_path.default.resolve(globalAgentsDir, agentId);
@@ -383,7 +352,7 @@ class LocalAgentRegistry {
     if (this.hasAgent(agentId)) {
       if (autoInstall) {
         import_core.logger.info(`Installing agent '${agentId}' from registry...`);
-        return await this.installAgent(agentId, injectPreferences);
+        return await this.installAgent(agentId);
       } else {
         const registry2 = this.getRegistry();
         const available2 = Object.keys(registry2.agents);
@@ -419,8 +388,8 @@ class LocalAgentRegistry {
       const defaultAgent = preferences.defaults.defaultAgent;
       return agentId !== defaultAgent;
     } catch {
-      import_core.logger.warn("Could not load preferences, using fallback protection for default-agent");
-      return agentId !== "default-agent";
+      import_core.logger.warn("Could not load preferences, using fallback protection for coding-agent");
+      return agentId !== "coding-agent";
     }
   }
   /**
@@ -472,8 +441,22 @@ function getAgentRegistry() {
   }
   return cachedRegistry;
 }
+function loadBundledRegistryAgents() {
+  try {
+    const registryPath = (0, import_path2.resolveBundledScript)("agents/agent-registry.json");
+    const content = (0, import_fs.readFileSync)(registryPath, "utf-8");
+    const registry = JSON.parse(content);
+    return registry.agents || {};
+  } catch (error) {
+    import_core.logger.warn(
+      `Could not load bundled registry: ${error instanceof Error ? error.message : String(error)}`
+    );
+    return {};
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LocalAgentRegistry,
-  getAgentRegistry
+  getAgentRegistry,
+  loadBundledRegistryAgents
 });

package/dist/registry/registry.d.ts

@@ -79,15 +79,13 @@ export declare class LocalAgentRegistry implements AgentRegistry {
     /**
      * Install agent atomically using temp + rename pattern
      * @param agentId ID of the agent to install
-     * @param injectPreferences Whether to inject global preferences into installed agent (default: true)
      */
-    installAgent(agentId: string, injectPreferences?: boolean): Promise<string>;
+    installAgent(agentId: string): Promise<string>;
     /**
      * Install a custom agent from a local file path
      * @param agentId Unique identifier for the custom agent
      * @param sourcePath Absolute path to agent YAML file or directory
      * @param metadata Agent metadata (name for display, description, author, tags, main)
-     * @param injectPreferences Whether to inject global preferences (default: true)
      * @returns Path to the installed agent's main config file
      */
     installCustomAgentFromPath(agentId: string, sourcePath: string, metadata: {
@@ -96,16 +94,15 @@ export declare class LocalAgentRegistry implements AgentRegistry {
         author: string;
         tags: string[];
         main?: string;
-    }, injectPreferences?: boolean): Promise<string>;
+    }): Promise<string>;
     /**
      * Resolve a registry agent ID to a config path
      * NOTE: Only handles registry IDs, not file paths (routing done in loadAgentConfig)
      * Handles installing agent if needed
      * @param agentId ID of the agent to resolve
      * @param autoInstall Whether to automatically install missing agents from registry (default: true)
-     * @param injectPreferences Whether to inject preferences during auto-installation (default: true)
      */
-    resolveAgent(agentId: string, autoInstall?: boolean, injectPreferences?: boolean): Promise<string>;
+    resolveAgent(agentId: string, autoInstall?: boolean): Promise<string>;
     /**
      * Get list of currently installed agents
      */
@@ -127,4 +124,9 @@ export declare class LocalAgentRegistry implements AgentRegistry {
  * Get cached registry instance (singleton pattern)
  */
 export declare function getAgentRegistry(): LocalAgentRegistry;
+/**
+ * Load bundled agent registry (agents field only)
+ * Returns empty object on error - use for non-critical lookups like display names
+ */
+export declare function loadBundledRegistryAgents(): Record<string, AgentRegistryEntry>;
 //# sourceMappingURL=registry.d.ts.map

package/dist/registry/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"AAOA,OAAO,EACH,QAAQ,EAER,aAAa,EACb,kBAAkB,EAErB,MAAM,YAAY,CAAC;AAYpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACpD,OAAO,CAAC,SAAS,CAAyB;IAE1C;;OAEG;IACH,WAAW,IAAI,QAAQ;IAOvB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAyCpB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAKlC;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAKxD;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAqC5D;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAqGvF;;;;;;;OAOG;IACG,0BAA0B,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,EACD,iBAAiB,GAAE,OAAc,GAClC,OAAO,CAAC,MAAM,CAAC;IAqKlB;;;;;;;OAOG;IACG,YAAY,CACd,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,OAAc,EAC3B,iBAAiB,GAAE,OAAc,GAClC,OAAO,CAAC,MAAM,CAAC;IAsClB;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAsB7C;;OAEG;YACW,sBAAsB;IAYpC;;;;;;OAMG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CA8C/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,CAKrD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,QAAQ,EAER,aAAa,EACb,kBAAkB,EAErB,MAAM,YAAY,CAAC;AAapB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACpD,OAAO,CAAC,SAAS,CAAyB;IAE1C;;OAEG;IACH,WAAW,IAAI,QAAQ;IAOvB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAyCpB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAKlC;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAKxD;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IA0C5D;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgFpD;;;;;;OAMG;IACG,0BAA0B,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,GACF,OAAO,CAAC,MAAM,CAAC;IAqJlB;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAsCjF;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAsB7C;;OAEG;YACW,sBAAsB;IAYpC;;;;;;OAMG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CA8C/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,CAKrD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAY9E"}