@dexto/agent-management 1.5.0 → 1.5.2

package/dist/config/config-enrichment.cjs

@@ -29,6 +29,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var config_enrichment_exports = {};
 __export(config_enrichment_exports, {
   deriveAgentId: () => deriveAgentId,
+  discoverAgentInstructionFile: () => import_discover_prompts2.discoverAgentInstructionFile,
   discoverCommandPrompts: () => import_discover_prompts2.discoverCommandPrompts,
   enrichAgentConfig: () => enrichAgentConfig
 });
@@ -38,6 +39,10 @@ var path = __toESM(require("path"), 1);
 var import_discover_prompts = require("./discover-prompts.js");
 var import_discover_prompts2 = require("./discover-prompts.js");
 function deriveAgentId(config, configPath) {
+  if (config.agentId) {
+    const sanitizedId = config.agentId.toLowerCase().replace(/[^a-z0-9-_]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+    return sanitizedId || "coding-agent";
+  }
   if (config.agentCard?.name) {
     const sanitizedName = config.agentCard.name.toLowerCase().replace(/[^a-z0-9-_]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
     if (sanitizedName) {
@@ -127,11 +132,55 @@ function enrichAgentConfig(config, configPath, options = {}) {
     );
     enriched.prompts = [...existingPrompts, ...filteredDiscovered];
   }
+  const instructionFile = (0, import_discover_prompts.discoverAgentInstructionFile)();
+  if (instructionFile) {
+    const fileContributor = {
+      id: "discovered-instructions",
+      type: "file",
+      priority: 5,
+      enabled: true,
+      files: [instructionFile],
+      options: {
+        includeFilenames: true,
+        errorHandling: "skip",
+        maxFileSize: 1e5
+      }
+    };
+    if (!config.systemPrompt) {
+      enriched.systemPrompt = {
+        contributors: [fileContributor]
+      };
+    } else if (typeof config.systemPrompt === "string") {
+      enriched.systemPrompt = {
+        contributors: [
+          {
+            id: "inline",
+            type: "static",
+            content: config.systemPrompt,
+            priority: 0,
+            enabled: true
+          },
+          fileContributor
+        ]
+      };
+    } else if ("contributors" in config.systemPrompt) {
+      const existingContributors = config.systemPrompt.contributors ?? [];
+      const hasDiscoveredInstructions = existingContributors.some(
+        (c) => c.id === "discovered-instructions"
+      );
+      if (!hasDiscoveredInstructions) {
+        enriched.systemPrompt = {
+          contributors: [...existingContributors, fileContributor]
+        };
+      }
+    }
+  }
   return enriched;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   deriveAgentId,
+  discoverAgentInstructionFile,
   discoverCommandPrompts,
   enrichAgentConfig
 });

package/dist/config/config-enrichment.d.ts

@@ -12,10 +12,10 @@
  * Core services now require explicit paths - this enrichment layer provides them.
  */
 import type { AgentConfig } from '@dexto/core';
-export { discoverCommandPrompts } from './discover-prompts.js';
+export { discoverCommandPrompts, discoverAgentInstructionFile } from './discover-prompts.js';
 /**
  * Derives an agent ID from config or file path for per-agent isolation.
- * Priority: agentCard.name > filename (without extension) > 'coding-agent'
+ * Priority: explicit agentId > agentCard.name > filename (without extension) > 'coding-agent'
  */
 export declare function deriveAgentId(config: AgentConfig, configPath?: string): string;
 /**

package/dist/config/config-enrichment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-enrichment.d.ts","sourceRoot":"","sources":["../../src/config/config-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAyB9E;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAClD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,wBAAwB,GAAG,OAAY,GACjD,WAAW,CA+Gb"}
+{"version":3,"file":"config-enrichment.d.ts","sourceRoot":"","sources":["../../src/config/config-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE7F;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAoC9E;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAClD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,wBAAwB,GAAG,OAAY,GACjD,WAAW,CAoKb"}

package/dist/config/config-enrichment.js

@@ -1,8 +1,12 @@
 import { getDextoPath } from "../utils/path.js";
 import * as path from "path";
-import { discoverCommandPrompts } from "./discover-prompts.js";
-import { discoverCommandPrompts as discoverCommandPrompts2 } from "./discover-prompts.js";
+import { discoverCommandPrompts, discoverAgentInstructionFile } from "./discover-prompts.js";
+import { discoverCommandPrompts as discoverCommandPrompts2, discoverAgentInstructionFile as discoverAgentInstructionFile2 } from "./discover-prompts.js";
 function deriveAgentId(config, configPath) {
+  if (config.agentId) {
+    const sanitizedId = config.agentId.toLowerCase().replace(/[^a-z0-9-_]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+    return sanitizedId || "coding-agent";
+  }
   if (config.agentCard?.name) {
     const sanitizedName = config.agentCard.name.toLowerCase().replace(/[^a-z0-9-_]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
     if (sanitizedName) {
@@ -92,10 +96,54 @@ function enrichAgentConfig(config, configPath, options = {}) {
     );
     enriched.prompts = [...existingPrompts, ...filteredDiscovered];
   }
+  const instructionFile = discoverAgentInstructionFile();
+  if (instructionFile) {
+    const fileContributor = {
+      id: "discovered-instructions",
+      type: "file",
+      priority: 5,
+      enabled: true,
+      files: [instructionFile],
+      options: {
+        includeFilenames: true,
+        errorHandling: "skip",
+        maxFileSize: 1e5
+      }
+    };
+    if (!config.systemPrompt) {
+      enriched.systemPrompt = {
+        contributors: [fileContributor]
+      };
+    } else if (typeof config.systemPrompt === "string") {
+      enriched.systemPrompt = {
+        contributors: [
+          {
+            id: "inline",
+            type: "static",
+            content: config.systemPrompt,
+            priority: 0,
+            enabled: true
+          },
+          fileContributor
+        ]
+      };
+    } else if ("contributors" in config.systemPrompt) {
+      const existingContributors = config.systemPrompt.contributors ?? [];
+      const hasDiscoveredInstructions = existingContributors.some(
+        (c) => c.id === "discovered-instructions"
+      );
+      if (!hasDiscoveredInstructions) {
+        enriched.systemPrompt = {
+          contributors: [...existingContributors, fileContributor]
+        };
+      }
+    }
+  }
   return enriched;
 }
 export {
   deriveAgentId,
+  discoverAgentInstructionFile2 as discoverAgentInstructionFile,
   discoverCommandPrompts2 as discoverCommandPrompts,
   enrichAgentConfig
 };

package/dist/config/discover-prompts.cjs

@@ -28,6 +28,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var discover_prompts_exports = {};
 __export(discover_prompts_exports, {
+  discoverAgentInstructionFile: () => discoverAgentInstructionFile,
   discoverCommandPrompts: () => discoverCommandPrompts
 });
 module.exports = __toCommonJS(discover_prompts_exports);
@@ -97,7 +98,29 @@ function scanCommandsDirectory(dir) {
   }
   return files;
 }
+const AGENT_INSTRUCTION_FILES = ["agents.md", "claude.md", "gemini.md"];
+function discoverAgentInstructionFile() {
+  const cwd = process.cwd();
+  let dirEntries;
+  try {
+    dirEntries = (0, import_fs.readdirSync)(cwd);
+  } catch {
+    return null;
+  }
+  const lowercaseMap = /* @__PURE__ */ new Map();
+  for (const entry of dirEntries) {
+    lowercaseMap.set(entry.toLowerCase(), entry);
+  }
+  for (const filename of AGENT_INSTRUCTION_FILES) {
+    const actualFilename = lowercaseMap.get(filename);
+    if (actualFilename) {
+      return path.join(cwd, actualFilename);
+    }
+  }
+  return null;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  discoverAgentInstructionFile,
   discoverCommandPrompts
 });

package/dist/config/discover-prompts.d.ts

@@ -25,4 +25,17 @@ export interface FilePromptEntry {
  * @returns Array of file prompt entries for discovered .md files
  */
 export declare function discoverCommandPrompts(): FilePromptEntry[];
+/**
+ * Discovers agent instruction files from the current working directory.
+ *
+ * Looks for files in this order of priority (case-insensitive):
+ * 1. AGENTS.md (or agents.md, Agents.md, etc.)
+ * 2. CLAUDE.md (or claude.md, Claude.md, etc.)
+ * 3. GEMINI.md (or gemini.md, Gemini.md, etc.)
+ *
+ * Only the first found file is returned (we don't want multiple instruction files).
+ *
+ * @returns The absolute path to the first found instruction file, or null if none found
+ */
+export declare function discoverAgentInstructionFile(): string | null;
 //# sourceMappingURL=discover-prompts.d.ts.map

package/dist/config/discover-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discover-prompts.d.ts","sourceRoot":"","sources":["../../src/config/discover-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,EAAE,CA8D1D"}
+{"version":3,"file":"discover-prompts.d.ts","sourceRoot":"","sources":["../../src/config/discover-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,EAAE,CA8D1D;AAiCD;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,GAAG,IAAI,CA0B5D"}

package/dist/config/discover-prompts.js

@@ -68,6 +68,28 @@ function scanCommandsDirectory(dir) {
   }
   return files;
 }
+const AGENT_INSTRUCTION_FILES = ["agents.md", "claude.md", "gemini.md"];
+function discoverAgentInstructionFile() {
+  const cwd = process.cwd();
+  let dirEntries;
+  try {
+    dirEntries = readdirSync(cwd);
+  } catch {
+    return null;
+  }
+  const lowercaseMap = /* @__PURE__ */ new Map();
+  for (const entry of dirEntries) {
+    lowercaseMap.set(entry.toLowerCase(), entry);
+  }
+  for (const filename of AGENT_INSTRUCTION_FILES) {
+    const actualFilename = lowercaseMap.get(filename);
+    if (actualFilename) {
+      return path.join(cwd, actualFilename);
+    }
+  }
+  return null;
+}
 export {
+  discoverAgentInstructionFile,
   discoverCommandPrompts
 };

package/dist/models/custom-models.cjs

@@ -63,7 +63,10 @@ const CustomModelSchema = import_zod.z.object({
   apiKey: import_zod.z.string().optional(),
   // File path for local GGUF models. Required when provider is 'local'.
   // Stores the absolute path to the .gguf file on disk.
-  filePath: import_zod.z.string().optional()
+  filePath: import_zod.z.string().optional(),
+  // OpenAI reasoning effort level for reasoning-capable models (o1, o3, codex, gpt-5.x).
+  // Controls how many reasoning tokens the model generates before producing a response.
+  reasoningEffort: import_zod.z.enum(["none", "minimal", "low", "medium", "high", "xhigh"]).optional()
 }).superRefine((data, ctx) => {
   if ((data.provider === "openai-compatible" || data.provider === "litellm") && !data.baseURL) {
     ctx.addIssue({

package/dist/models/custom-models.d.ts

@@ -33,11 +33,13 @@ export declare const CustomModelSchema: z.ZodEffects<z.ZodObject<{
     maxOutputTokens: z.ZodOptional<z.ZodNumber>;
     apiKey: z.ZodOptional<z.ZodString>;
     filePath: z.ZodOptional<z.ZodString>;
+    reasoningEffort: z.ZodOptional<z.ZodEnum<["none", "minimal", "low", "medium", "high", "xhigh"]>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     provider: "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
     apiKey?: string | undefined;
     baseURL?: string | undefined;
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     filePath?: string | undefined;
     displayName?: string | undefined;
     maxInputTokens?: number | undefined;
@@ -47,6 +49,7 @@ export declare const CustomModelSchema: z.ZodEffects<z.ZodObject<{
     provider?: "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | undefined;
     apiKey?: string | undefined;
     baseURL?: string | undefined;
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     filePath?: string | undefined;
     displayName?: string | undefined;
     maxInputTokens?: number | undefined;
@@ -56,6 +59,7 @@ export declare const CustomModelSchema: z.ZodEffects<z.ZodObject<{
     provider: "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
     apiKey?: string | undefined;
     baseURL?: string | undefined;
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     filePath?: string | undefined;
     displayName?: string | undefined;
     maxInputTokens?: number | undefined;
@@ -65,6 +69,7 @@ export declare const CustomModelSchema: z.ZodEffects<z.ZodObject<{
     provider?: "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | undefined;
     apiKey?: string | undefined;
     baseURL?: string | undefined;
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     filePath?: string | undefined;
     displayName?: string | undefined;
     maxInputTokens?: number | undefined;

package/dist/models/custom-models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom-models.d.ts","sourceRoot":"","sources":["../../src/models/custom-models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,2CAA2C;AAC3C,eAAO,MAAM,sBAAsB,0GASzB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CxB,CAAC;AAEP,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAO7D;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAmB/D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUtE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG9E"}
+{"version":3,"file":"custom-models.d.ts","sourceRoot":"","sources":["../../src/models/custom-models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,2CAA2C;AAC3C,eAAO,MAAM,sBAAsB,0GASzB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8CxB,CAAC;AAEP,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAO7D;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAmB/D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUtE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG9E"}

package/dist/models/custom-models.js

@@ -24,7 +24,10 @@ const CustomModelSchema = z.object({
   apiKey: z.string().optional(),
   // File path for local GGUF models. Required when provider is 'local'.
   // Stores the absolute path to the .gguf file on disk.
-  filePath: z.string().optional()
+  filePath: z.string().optional(),
+  // OpenAI reasoning effort level for reasoning-capable models (o1, o3, codex, gpt-5.x).
+  // Controls how many reasoning tokens the model generates before producing a response.
+  reasoningEffort: z.enum(["none", "minimal", "low", "medium", "high", "xhigh"]).optional()
 }).superRefine((data, ctx) => {
   if ((data.provider === "openai-compatible" || data.provider === "litellm") && !data.baseURL) {
     ctx.addIssue({

package/dist/preferences/loader.cjs

@@ -105,6 +105,9 @@ function createInitialPreferences(providerOrOptions, model, apiKeyVar, defaultAg
     if (opts.baseURL) {
       llmConfig.baseURL = opts.baseURL;
     }
+    if (opts.reasoningEffort) {
+      llmConfig.reasoningEffort = opts.reasoningEffort;
+    }
     return {
       llm: llmConfig,
       defaults: {

package/dist/preferences/loader.d.ts

@@ -34,6 +34,8 @@ export interface CreatePreferencesOptions {
     defaultAgent?: string;
     defaultMode?: 'cli' | 'web' | 'server' | 'discord' | 'telegram' | 'mcp';
     baseURL?: string;
+    /** Reasoning effort for OpenAI reasoning models (o1, o3, codex, gpt-5.x) */
+    reasoningEffort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
     setupCompleted?: boolean;
     /** Whether API key setup was skipped and needs to be configured later */
     apiKeyPending?: boolean;

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;;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"}
+{"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,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3E,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;AAgErB;;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

@@ -77,6 +77,9 @@ function createInitialPreferences(providerOrOptions, model, apiKeyVar, defaultAg
     if (opts.baseURL) {
       llmConfig.baseURL = opts.baseURL;
     }
+    if (opts.reasoningEffort) {
+      llmConfig.reasoningEffort = opts.reasoningEffort;
+    }
     return {
       llm: llmConfig,
       defaults: {

package/dist/preferences/schemas.cjs

@@ -39,7 +39,10 @@ const PreferenceLLMSchema = import_zod.z.object({
   ).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)")
+  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)"),
+  reasoningEffort: import_zod.z.enum(["none", "minimal", "low", "medium", "high", "xhigh"]).optional().describe(
+    "Reasoning effort level for OpenAI reasoning models (o1, o3, codex, gpt-5.x). Auto-detected if not set."
+  )
 }).strict().superRefine((data, ctx) => {
   const skipModelValidation = (0, import_core.acceptsAnyModel)(data.provider) || (0, import_core.supportsCustomModels)(data.provider);
   if (!skipModelValidation && !(0, import_core.isValidProviderModel)(data.provider, data.model)) {

package/dist/preferences/schemas.d.ts

@@ -4,26 +4,31 @@ export declare const PreferenceLLMSchema: z.ZodEffects<z.ZodObject<{
     model: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
     apiKey: z.ZodOptional<z.ZodString>;
     baseURL: z.ZodOptional<z.ZodString>;
+    reasoningEffort: z.ZodOptional<z.ZodEnum<["none", "minimal", "low", "medium", "high", "xhigh"]>>;
 }, "strict", z.ZodTypeAny, {
     provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
     model: string;
     apiKey?: string | undefined;
     baseURL?: string | undefined;
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
 }, {
     provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
     model: string;
     apiKey?: string | undefined;
     baseURL?: string | undefined;
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
 }>, {
     provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
     model: string;
     apiKey?: string | undefined;
     baseURL?: string | undefined;
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
 }, {
     provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
     model: string;
     apiKey?: string | undefined;
     baseURL?: string | undefined;
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
 }>;
 export declare const PreferenceDefaultsSchema: z.ZodObject<{
     defaultAgent: z.ZodString;
@@ -54,26 +59,31 @@ export declare const GlobalPreferencesSchema: z.ZodObject<{
         model: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
         apiKey: z.ZodOptional<z.ZodString>;
         baseURL: z.ZodOptional<z.ZodString>;
+        reasoningEffort: z.ZodOptional<z.ZodEnum<["none", "minimal", "low", "medium", "high", "xhigh"]>>;
     }, "strict", z.ZodTypeAny, {
         provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
         apiKey?: string | undefined;
         baseURL?: string | undefined;
+        reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     }, {
         provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
         apiKey?: string | undefined;
         baseURL?: string | undefined;
+        reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     }>, {
         provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
         apiKey?: string | undefined;
         baseURL?: string | undefined;
+        reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     }, {
         provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
         apiKey?: string | undefined;
         baseURL?: string | undefined;
+        reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     }>;
     defaults: z.ZodObject<{
         defaultAgent: z.ZodString;
@@ -104,6 +114,7 @@ export declare const GlobalPreferencesSchema: z.ZodObject<{
         model: string;
         apiKey?: string | undefined;
         baseURL?: string | undefined;
+        reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     };
     defaults: {
         defaultAgent: string;
@@ -120,6 +131,7 @@ export declare const GlobalPreferencesSchema: z.ZodObject<{
         model: string;
         apiKey?: string | undefined;
         baseURL?: string | undefined;
+        reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     };
     defaults: {
         defaultAgent: string;

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;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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsE1B,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

@@ -19,7 +19,10 @@ const PreferenceLLMSchema = z.object({
   ).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)")
+  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)"),
+  reasoningEffort: z.enum(["none", "minimal", "low", "medium", "high", "xhigh"]).optional().describe(
+    "Reasoning effort level for OpenAI reasoning models (o1, o3, codex, gpt-5.x). Auto-detected if not set."
+  )
 }).strict().superRefine((data, ctx) => {
   const skipModelValidation = acceptsAnyModel(data.provider) || supportsCustomModels(data.provider);
   if (!skipModelValidation && !isValidProviderModel(data.provider, data.model)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/agent-management",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -16,7 +16,7 @@
   "dependencies": {
     "yaml": "^2.7.1",
     "zod": "^3.25.0",
-    "@dexto/core": "1.5.0"
+    "@dexto/core": "1.5.2"
   },
   "devDependencies": {
     "@types/node": "^22.13.5"