@aigne/doc-smith 0.8.15-beta.14 → 0.8.15-beta.15

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.8.15-beta.15](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.15-beta.14...v0.8.15-beta.15) (2025-11-07)
+
+
+### Bug Fixes
+
+* add two-tier thinking effort configuration system ([#273](https://github.com/AIGNE-io/aigne-doc-smith/issues/273)) ([b72d066](https://github.com/AIGNE-io/aigne-doc-smith/commit/b72d066698bae253a9ee2dfa231bf73cd59d7529))
+
 ## [0.8.15-beta.14](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.15-beta.13...v0.8.15-beta.14) (2025-11-06)
 
 

package/agents/init/index.mjs

@@ -4,6 +4,8 @@ import chalk from "chalk";
 import { stringify as yamlStringify } from "yaml";
 import { getFilteredOptions } from "../../utils/conflict-detector.mjs";
 import {
+  DEFAULT_REASONING_EFFORT_LEVEL,
+  DEFAULT_THINKING_EFFORT_LEVEL,
   DEPTH_RECOMMENDATION_LOGIC,
   DOCUMENT_STYLES,
   DOCUMENTATION_DEPTH,
@@ -22,11 +24,10 @@ import {
 } from "../../utils/utils.mjs";
 import { isRemoteFile } from "../../utils/file-utils.mjs";
 import { validateDocDir } from "./validate.mjs";
+import mapReasoningEffortLevel from "../utils/map-reasoning-effort-level.mjs";
 
 const _PRESS_ENTER_TO_FINISH = "Press Enter to finish";
 
-const DEFAULT_REASONING_EFFORT = 502;
-
 /**
  * Guides the user through a multi-turn dialog to generate a YAML configuration file.
  * @param {Object} params
@@ -37,7 +38,15 @@ const DEFAULT_REASONING_EFFORT = 502;
 export default async function init(input, options) {
   const config = await _init(input, options);
 
-  options.context.userContext.reasoningEffort = config.reasoningEffort || DEFAULT_REASONING_EFFORT;
+  // Set thinking effort (lite/standard/pro) and map to reasoningEffort
+  options.context.userContext.thinkingEffort =
+    config.thinking?.effort || DEFAULT_THINKING_EFFORT_LEVEL;
+
+  // Set global reasoningEffort based on thinkingEffort
+  options.context.userContext.reasoningEffort = mapReasoningEffortLevel(
+    { level: DEFAULT_REASONING_EFFORT_LEVEL },
+    options,
+  )?.reasoningEffort;
 
   return config;
 }
@@ -398,8 +407,6 @@ async function _init(
   input.projectDesc = projectInfo.description;
   input.projectLogo = projectInfo.icon;
 
-  input.reasoningEffort = DEFAULT_REASONING_EFFORT;
-
   // Generate YAML content
   const yamlContent = generateYAML(input, outputPath);
 
@@ -450,7 +457,9 @@ export function generateYAML(input) {
     projectDesc: input.projectDesc || "",
     projectLogo: input.projectLogo || "",
 
-    reasoningEffort: input.reasoningEffort || 502,
+    thinking: {
+      effort: input.thinking?.effort || DEFAULT_THINKING_EFFORT_LEVEL,
+    },
 
     // Documentation configuration
     documentPurpose: input.documentPurpose || [],
@@ -488,14 +497,15 @@ export function generateYAML(input) {
   yaml += `${projectSection}\n\n`;
 
   const modelSection = yamlStringify({
-    reasoningEffort: config.reasoningEffort,
+    thinking: config.thinking,
   }).trim();
 
   yaml += `\
-# Model Configuration
-
-# Reasoning Effort: Level of reasoning effort for AI model, lower is faster but less thorough.
-# Options: minimal, low, medium, high, or numeric values 128-32768.
+# AI Thinking Configuration
+# thinking.effort: Determines the depth of reasoning and cognitive effort the AI uses when responding, available options:
+#   - lite: Fast responses with basic reasoning
+#   - standard: Balanced speed and reasoning capability
+#   - pro: In-depth reasoning with longer response times
 ${modelSection}
 \n`;
 

package/agents/utils/map-reasoning-effort-level.mjs

@@ -0,0 +1,15 @@
+import {
+  DEFAULT_REASONING_EFFORT_LEVEL,
+  DEFAULT_REASONING_EFFORT_VALUE,
+  REASONING_EFFORT_LEVELS,
+} from "../../utils/constants/index.mjs";
+
+export default function mapReasoningEffortLevel({ level }, options) {
+  const g =
+    REASONING_EFFORT_LEVELS[level] || REASONING_EFFORT_LEVELS[DEFAULT_REASONING_EFFORT_LEVEL];
+
+  return {
+    reasoningEffort:
+      g[options.context.userContext.thinkingEffort] ?? DEFAULT_REASONING_EFFORT_VALUE,
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/doc-smith",
-  "version": "0.8.15-beta.14",
+  "version": "0.8.15-beta.15",
   "description": "AI-driven documentation generation tool built on the AIGNE Framework",
   "publishConfig": {
     "access": "public"

package/utils/constants/index.mjs

@@ -555,3 +555,35 @@ export const DOC_ACTION = {
   update: "update",
   clear: "clear",
 };
+
+// Default thinking effort level, available options: 'lite', 'standard', 'pro'
+// This level can be defined by the user in the config file to influence reasoning effort mapping
+export const DEFAULT_THINKING_EFFORT_LEVEL = "standard";
+
+// Default reasoning effort level, available options: 'minimal', 'low', 'medium', 'high'
+export const DEFAULT_REASONING_EFFORT_LEVEL = "low";
+
+export const DEFAULT_REASONING_EFFORT_VALUE = 500;
+
+export const REASONING_EFFORT_LEVELS = {
+  minimal: {
+    lite: 100,
+    standard: 300,
+    pro: 500,
+  },
+  low: {
+    lite: 200,
+    standard: 500,
+    pro: 1000,
+  },
+  medium: {
+    lite: 300,
+    standard: 800,
+    pro: 1500,
+  },
+  high: {
+    lite: 500,
+    standard: 1000,
+    pro: 2000,
+  },
+};