feat: enhance SDK options with thinking level support

- Introduced a new function, buildThinkingOptions, to handle the conversion of ThinkingLevel to maxThinkingTokens for the Claude SDK.
- Updated existing SDK option creation functions to incorporate thinking options, ensuring that maxThinkingTokens are included based on the specified thinking level.
- Enhanced the settings service to support migration of phase models to include thinking levels, improving compatibility with new configurations.
- Added comprehensive tests for thinking level integration and migration logic, ensuring robust functionality across the application.

This update significantly improves the SDK's configurability and performance by allowing for more nuanced control over reasoning capabilities.

apps/server/src/routes/app-spec/generate-features-from-spec.ts

@@ -10,7 +10,7 @@ import * as secureFs from '../../lib/secure-fs.js';
 import type { EventEmitter } from '../../lib/events.js';
 import { createLogger } from '@automaker/utils';
 import { DEFAULT_PHASE_MODELS, isCursorModel } from '@automaker/types';
-import { resolveModelString } from '@automaker/model-resolver';
+import { resolvePhaseModel } from '@automaker/model-resolver';
 import { createFeatureGenerationOptions } from '../../lib/sdk-options.js';
 import { ProviderFactory } from '../../providers/provider-factory.js';
 import { logAuthStatus } from './common.js';
@@ -109,9 +109,9 @@ IMPORTANT: Do not ask for clarification. The specification is provided above. Ge
 
   // Get model from phase settings
   const settings = await settingsService?.getGlobalSettings();
-  const featureGenerationModel =
+  const phaseModelEntry =
     settings?.phaseModels?.featureGenerationModel || DEFAULT_PHASE_MODELS.featureGenerationModel;
-  const model = resolveModelString(featureGenerationModel);
+  const { model, thinkingLevel } = resolvePhaseModel(phaseModelEntry);
 
   logger.info('Using model:', model);
 
@@ -172,6 +172,7 @@ CRITICAL INSTRUCTIONS:
       abortController,
       autoLoadClaudeMd,
       model,
+      thinkingLevel, // Pass thinking level for extended thinking
     });
 
     logger.debug('SDK Options:', JSON.stringify(options, null, 2));

apps/server/src/routes/app-spec/generate-spec.ts

@@ -17,7 +17,7 @@ import {
 } from '../../lib/app-spec-format.js';
 import { createLogger } from '@automaker/utils';
 import { DEFAULT_PHASE_MODELS, isCursorModel } from '@automaker/types';
-import { resolveModelString } from '@automaker/model-resolver';
+import { resolvePhaseModel } from '@automaker/model-resolver';
 import { createSpecGenerationOptions } from '../../lib/sdk-options.js';
 import { extractJson } from '../../lib/json-extractor.js';
 import { ProviderFactory } from '../../providers/provider-factory.js';
@@ -102,9 +102,9 @@ ${getStructuredSpecPromptInstruction()}`;
 
   // Get model from phase settings
   const settings = await settingsService?.getGlobalSettings();
-  const specGenerationModel =
+  const phaseModelEntry =
     settings?.phaseModels?.specGenerationModel || DEFAULT_PHASE_MODELS.specGenerationModel;
-  const model = resolveModelString(specGenerationModel);
+  const { model, thinkingLevel } = resolvePhaseModel(phaseModelEntry);
 
   logger.info('Using model:', model);
 
@@ -185,6 +185,7 @@ Your entire response should be valid JSON starting with { and ending with }. No
       abortController,
       autoLoadClaudeMd,
       model,
+      thinkingLevel, // Pass thinking level for extended thinking
       outputFormat: {
         type: 'json_schema',
         schema: specOutputSchema,

apps/server/src/routes/backlog-plan/generate-plan.ts

@@ -7,7 +7,8 @@
 
 import type { EventEmitter } from '../../lib/events.js';
 import type { Feature, BacklogPlanResult, BacklogChange, DependencyUpdate } from '@automaker/types';
-import { DEFAULT_PHASE_MODELS, isCursorModel } from '@automaker/types';
+import { DEFAULT_PHASE_MODELS, isCursorModel, type ThinkingLevel } from '@automaker/types';
+import { resolvePhaseModel } from '@automaker/model-resolver';
 import { FeatureLoader } from '../../services/feature-loader.js';
 import { ProviderFactory } from '../../providers/provider-factory.js';
 import { extractJsonWithArray } from '../../lib/json-extractor.js';
@@ -107,10 +108,14 @@ export async function generateBacklogPlan(
 
     // Get the model to use from settings or provided override
     let effectiveModel = model;
+    let thinkingLevel: ThinkingLevel | undefined;
     if (!effectiveModel) {
       const settings = await settingsService?.getGlobalSettings();
-      effectiveModel =
+      const phaseModelEntry =
         settings?.phaseModels?.backlogPlanningModel || DEFAULT_PHASE_MODELS.backlogPlanningModel;
+      const resolved = resolvePhaseModel(phaseModelEntry);
+      effectiveModel = resolved.model;
+      thinkingLevel = resolved.thinkingLevel;
     }
     logger.info('[BacklogPlan] Using model:', effectiveModel);
 
@@ -154,6 +159,7 @@ ${userPrompt}`;
       abortController,
       settingSources: autoLoadClaudeMd ? ['user', 'project'] : undefined,
       readOnly: true, // Plan generation only generates text, doesn't write files
+      thinkingLevel, // Pass thinking level for extended thinking
     });
 
     let responseText = '';

apps/server/src/routes/context/routes/describe-file.ts

@@ -15,7 +15,7 @@ import { query } from '@anthropic-ai/claude-agent-sdk';
 import { createLogger } from '@automaker/utils';
 import { DEFAULT_PHASE_MODELS, isCursorModel } from '@automaker/types';
 import { PathNotAllowedError } from '@automaker/platform';
-import { resolveModelString } from '@automaker/model-resolver';
+import { resolvePhaseModel } from '@automaker/model-resolver';
 import { createCustomOptions } from '../../../lib/sdk-options.js';
 import { ProviderFactory } from '../../../providers/provider-factory.js';
 import * as secureFs from '../../../lib/secure-fs.js';
@@ -182,11 +182,16 @@ File: ${fileName}${truncated ? ' (truncated)' : ''}`;
 
       // Get model from phase settings
       const settings = await settingsService?.getGlobalSettings();
-      const fileDescriptionModel =
+      logger.info(
+        `[DescribeFile] Raw phaseModels from settings:`,
+        JSON.stringify(settings?.phaseModels, null, 2)
+      );
+      const phaseModelEntry =
         settings?.phaseModels?.fileDescriptionModel || DEFAULT_PHASE_MODELS.fileDescriptionModel;
-      const model = resolveModelString(fileDescriptionModel);
+      logger.info(`[DescribeFile] fileDescriptionModel entry:`, JSON.stringify(phaseModelEntry));
+      const { model, thinkingLevel } = resolvePhaseModel(phaseModelEntry);
 
-      logger.debug(`[DescribeFile] Using model: ${model}`);
+      logger.info(`[DescribeFile] Resolved model: ${model}, thinkingLevel: ${thinkingLevel}`);
 
       let description: string;
 
@@ -231,6 +236,7 @@ File: ${fileName}${truncated ? ' (truncated)' : ''}`;
           allowedTools: [],
           autoLoadClaudeMd,
           sandbox: { enabled: true, autoAllowBashIfSandboxed: true },
+          thinkingLevel, // Pass thinking level for extended thinking
         });
 
         const promptGenerator = (async function* () {

apps/server/src/routes/context/routes/describe-image.ts

@@ -15,7 +15,7 @@ import type { Request, Response } from 'express';
 import { query } from '@anthropic-ai/claude-agent-sdk';
 import { createLogger, readImageAsBase64 } from '@automaker/utils';
 import { DEFAULT_PHASE_MODELS, isCursorModel } from '@automaker/types';
-import { resolveModelString } from '@automaker/model-resolver';
+import { resolvePhaseModel } from '@automaker/model-resolver';
 import { createCustomOptions } from '../../../lib/sdk-options.js';
 import { ProviderFactory } from '../../../providers/provider-factory.js';
 import * as secureFs from '../../../lib/secure-fs.js';
@@ -342,9 +342,9 @@ export function createDescribeImageHandler(
 
       // Get model from phase settings
       const settings = await settingsService?.getGlobalSettings();
-      const imageDescriptionModel =
+      const phaseModelEntry =
         settings?.phaseModels?.imageDescriptionModel || DEFAULT_PHASE_MODELS.imageDescriptionModel;
-      const model = resolveModelString(imageDescriptionModel);
+      const { model, thinkingLevel } = resolvePhaseModel(phaseModelEntry);
 
       logger.info(`[${requestId}] Using model: ${model}`);
 
@@ -395,6 +395,7 @@ export function createDescribeImageHandler(
           allowedTools: [],
           autoLoadClaudeMd,
           sandbox: { enabled: true, autoAllowBashIfSandboxed: true },
+          thinkingLevel, // Pass thinking level for extended thinking
         });
 
         logger.info(

apps/server/src/routes/github/routes/validate-issue.ts

@@ -17,7 +17,8 @@ import type {
   GitHubComment,
   LinkedPRInfo,
 } from '@automaker/types';
-import { isCursorModel } from '@automaker/types';
+import { isCursorModel, DEFAULT_PHASE_MODELS } from '@automaker/types';
+import { resolvePhaseModel } from '@automaker/model-resolver';
 import { createSuggestionsOptions } from '../../../lib/sdk-options.js';
 import { extractJson } from '../../../lib/json-extractor.js';
 import { writeValidation } from '../../../lib/validation-storage.js';
@@ -174,6 +175,12 @@ ${prompt}`;
         '[ValidateIssue]'
       );
 
+      // Get thinkingLevel from phase model settings (the model comes from request, but thinkingLevel from settings)
+      const settings = await settingsService?.getGlobalSettings();
+      const phaseModelEntry =
+        settings?.phaseModels?.validationModel || DEFAULT_PHASE_MODELS.validationModel;
+      const { thinkingLevel } = resolvePhaseModel(phaseModelEntry);
+
       // Create SDK options with structured output and abort controller
       const options = createSuggestionsOptions({
         cwd: projectPath,
@@ -181,6 +188,7 @@ ${prompt}`;
         systemPrompt: ISSUE_VALIDATION_SYSTEM_PROMPT,
         abortController,
         autoLoadClaudeMd,
+        thinkingLevel,
         outputFormat: {
           type: 'json_schema',
           schema: issueValidationSchema as Record<string, unknown>,

apps/server/src/routes/suggestions/generate-suggestions.ts

@@ -9,7 +9,7 @@ import { query } from '@anthropic-ai/claude-agent-sdk';
 import type { EventEmitter } from '../../lib/events.js';
 import { createLogger } from '@automaker/utils';
 import { DEFAULT_PHASE_MODELS, isCursorModel } from '@automaker/types';
-import { resolveModelString } from '@automaker/model-resolver';
+import { resolvePhaseModel } from '@automaker/model-resolver';
 import { createSuggestionsOptions } from '../../lib/sdk-options.js';
 import { extractJsonWithArray } from '../../lib/json-extractor.js';
 import { ProviderFactory } from '../../providers/provider-factory.js';
@@ -173,9 +173,9 @@ The response will be automatically formatted as structured JSON.`;
 
   // Get model from phase settings (Feature Enhancement = enhancementModel)
   const settings = await settingsService?.getGlobalSettings();
-  const enhancementModel =
+  const phaseModelEntry =
     settings?.phaseModels?.enhancementModel || DEFAULT_PHASE_MODELS.enhancementModel;
-  const model = resolveModelString(enhancementModel);
+  const { model, thinkingLevel } = resolvePhaseModel(phaseModelEntry);
 
   logger.info('[Suggestions] Using model:', model);
 
@@ -247,6 +247,7 @@ Your entire response should be valid JSON starting with { and ending with }. No
       abortController,
       autoLoadClaudeMd,
       model, // Pass the model from settings
+      thinkingLevel, // Pass thinking level for extended thinking
       outputFormat: {
         type: 'json_schema',
         schema: suggestionsSchema,