takt 0.35.4 → 0.37.0

package/dist/features/tasks/execute/types.d.ts

@@ -4,20 +4,22 @@
 import type { Language } from '../../../core/models/index.js';
 import type { PersonaProviderEntry } from '../../../core/models/config-types.js';
 import type { ProviderPermissionProfiles } from '../../../core/models/provider-profiles.js';
-import type { MovementProviderOptions } from '../../../core/models/piece-types.js';
+import type { StepProviderOptions } from '../../../core/models/workflow-types.js';
+import type { WorkflowResumePoint } from '../../../core/models/index.js';
 import type { ProviderType } from '../../../infra/providers/index.js';
-import type { ProviderOptionsOriginResolver, ProviderOptionsSource } from '../../../core/piece/types.js';
+import type { ProviderOptionsOriginResolver, ProviderOptionsSource, ProviderResolutionSource } from '../../../core/workflow/provider-options-trace.js';
 /** Info captured when iteration limit is hit in non-interactive mode */
 export interface ExceededInfo {
-    currentMovement: string;
-    newMaxMovements: number;
+    currentStep: string;
+    newMaxSteps: number;
     currentIteration: number;
+    resumePoint?: WorkflowResumePoint;
 }
-/** Result of piece execution */
-export interface PieceExecutionResult {
+/** Result of workflow execution */
+export interface WorkflowExecutionResult {
     success: boolean;
     reason?: string;
-    lastMovement?: string;
+    lastStep?: string;
     lastMessage?: string;
     /** True when iteration limit was hit in non-interactive mode */
     exceeded?: boolean;
@@ -30,22 +32,26 @@ export interface InteractiveMetadata {
     /** The assembled task text (only meaningful when confirmed=true) */
     task?: string;
 }
-/** Options for piece execution */
-export interface PieceExecutionOptions {
+/** Options for workflow execution */
+export interface WorkflowExecutionOptions {
     /** Header prefix for display */
     headerPrefix?: string;
     /** Project root directory (where .takt/ lives). */
     projectCwd: string;
-    /** Override maxMovements from piece config (used when resuming exceeded tasks) */
-    maxMovementsOverride?: number;
+    /** Override maxSteps from workflow config (used when resuming exceeded tasks) */
+    maxStepsOverride?: number;
     /** Override initial iteration count (used when resuming exceeded tasks) */
     initialIterationOverride?: number;
     /** Language for instruction metadata */
     language?: Language;
     provider?: ProviderType;
+    /** Source layer of `provider`. */
+    providerSource?: ProviderResolutionSource;
     model?: string;
+    /** Source layer of `model`. */
+    modelSource?: ProviderResolutionSource;
     /** Resolved provider options */
-    providerOptions?: MovementProviderOptions;
+    providerOptions?: StepProviderOptions;
     /** Source layer for resolved provider options */
     providerOptionsSource?: ProviderOptionsSource;
     /** Nested origin resolver for resolved provider options */
@@ -58,10 +64,12 @@ export interface PieceExecutionOptions {
     interactiveUserInput?: boolean;
     /** Interactive mode result metadata for NDJSON logging */
     interactiveMetadata?: InteractiveMetadata;
-    /** Override initial movement (default: piece config's initialMovement) */
-    startMovement?: string;
+    /** Override initial step (default: workflow config's initialStep) */
+    startStep?: string;
     /** Retry note explaining why task is being retried */
     retryNote?: string;
+    /** Resume point for workflow_call-aware retries */
+    resumePoint?: WorkflowResumePoint;
     /** Override report directory name (e.g. "20260201-015714-foptng") */
     reportDirName?: string;
     /** External abort signal for parallel execution — when provided, SIGINT handling is delegated to caller */
@@ -72,34 +80,51 @@ export interface PieceExecutionOptions {
     taskDisplayLabel?: string;
     /** Color index for task prefix (cycled mod 4 across concurrent tasks) */
     taskColorIndex?: number;
+    /** Current task issue number for system-step context resolution */
+    currentTaskIssueNumber?: number;
 }
 export interface TaskExecutionOptions {
     provider?: ProviderType;
+    /** Source layer of `provider` (defaults to 'cli' when set via --provider). */
+    providerSource?: ProviderResolutionSource;
     model?: string;
+    /** Source layer of `model` (defaults to 'cli' when set via --model). */
+    modelSource?: ProviderResolutionSource;
+}
+export interface RunAllTasksOptions extends TaskExecutionOptions {
+    ignoreExceed?: boolean;
+}
+export interface TaskExecutionParallelOptions {
+    abortSignal?: AbortSignal;
+    taskPrefix?: string;
+    taskColorIndex?: number;
+    taskDisplayLabel?: string;
 }
 export interface ExecuteTaskOptions {
     /** Task content */
     task: string;
     /** Working directory (may be a clone path) */
     cwd: string;
-    /** Piece name or path (auto-detected by isPiecePath) */
-    pieceIdentifier: string;
+    /** Workflow name or path (auto-detected by isWorkflowPath) */
+    workflowIdentifier: string;
     /** Project root (where .takt/ lives) */
     projectCwd: string;
     /** Agent provider/model overrides */
     agentOverrides?: TaskExecutionOptions;
-    /** Override maxMovements from piece config (used when resuming exceeded tasks) */
-    maxMovementsOverride?: number;
+    /** Override maxSteps from workflow config (used when resuming exceeded tasks) */
+    maxStepsOverride?: number;
     /** Override initial iteration count (used when resuming exceeded tasks) */
     initialIterationOverride?: number;
     /** Enable interactive user input during step transitions */
     interactiveUserInput?: boolean;
     /** Interactive mode result metadata for NDJSON logging */
     interactiveMetadata?: InteractiveMetadata;
-    /** Override initial movement (default: piece config's initialMovement) */
-    startMovement?: string;
+    /** Override initial step (default: workflow config's initialStep) */
+    startStep?: string;
     /** Retry note explaining why task is being retried */
     retryNote?: string;
+    /** Resume point for workflow_call-aware retries */
+    resumePoint?: WorkflowResumePoint;
     /** Override report directory name (e.g. "20260201-015714-foptng") */
     reportDirName?: string;
     /** External abort signal for parallel execution — when provided, SIGINT handling is delegated to caller */
@@ -110,6 +135,8 @@ export interface ExecuteTaskOptions {
     taskDisplayLabel?: string;
     /** Color index for task prefix (cycled mod 4 across concurrent tasks) */
     taskColorIndex?: number;
+    /** Current task issue number for system-step context resolution */
+    currentTaskIssueNumber?: number;
 }
 export interface PipelineExecutionOptions {
     /** GitHub issue number */
@@ -118,8 +145,8 @@ export interface PipelineExecutionOptions {
     prNumber?: number;
     /** Task content (alternative to issue) */
     task?: string;
-    /** Piece name or path to piece file */
-    piece: string;
+    /** Workflow name or path to workflow file */
+    workflow: string;
     /** Branch name (auto-generated if omitted) */
     branch?: string;
     /** Whether to create a PR after successful execution */
@@ -128,7 +155,7 @@ export interface PipelineExecutionOptions {
     draftPr?: boolean;
     /** Repository in owner/repo format */
     repo?: string;
-    /** Skip branch creation, commit, and push (piece-only execution) */
+    /** Skip branch creation, commit, and push (workflow-only execution) */
     skipGit?: boolean;
     /** Working directory */
     cwd: string;
@@ -145,7 +172,7 @@ export interface WorktreeConfirmationResult {
     taskSlug?: string;
 }
 export interface SelectAndExecuteOptions {
-    piece?: string;
+    workflow?: string;
     /** Enable interactive user input during step transitions */
     interactiveUserInput?: boolean;
     /** Interactive mode result metadata for NDJSON logging */

package/dist/features/tasks/execute/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/features/tasks/execute/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/features/tasks/execute/types.ts"],"names":[],"mappings":"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"}

package/dist/features/tasks/execute/workflowExecution.d.ts

@@ -0,0 +1,9 @@
+import type { WorkflowConfig } from '../../../core/models/index.js';
+import type { WorkflowExecutionResult, WorkflowExecutionOptions } from './types.js';
+export type { WorkflowExecutionResult, WorkflowExecutionOptions };
+type WorkflowRunContext = {
+    ignoreIterationLimit?: boolean;
+};
+export declare function executeWorkflow(workflowConfig: WorkflowConfig, task: string, cwd: string, options: WorkflowExecutionOptions): Promise<WorkflowExecutionResult>;
+export declare function executeWorkflowForRun(workflowConfig: WorkflowConfig, task: string, cwd: string, options: WorkflowExecutionOptions, runContext?: WorkflowRunContext): Promise<WorkflowExecutionResult>;
+//# sourceMappingURL=workflowExecution.d.ts.map

package/dist/features/tasks/execute/workflowExecution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowExecution.d.ts","sourceRoot":"","sources":["../../../../src/features/tasks/execute/workflowExecution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAA4B,MAAM,+BAA+B,CAAC;AAC9F,OAAO,KAAK,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AASpF,YAAY,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,CAAC;AAElE,KAAK,kBAAkB,GAAG;IACxB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,wBAAsB,eAAe,CACnC,cAAc,EAAE,cAAc,EAC9B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,wBAAsB,qBAAqB,CACzC,cAAc,EAAE,cAAc,EAC9B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,wBAAwB,EACjC,UAAU,CAAC,EAAE,kBAAkB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAElC"}

package/dist/features/tasks/execute/workflowExecution.js

@@ -0,0 +1,145 @@
+import { WorkflowEngine, createDenyAskUserQuestionHandler } from '../../../core/workflow/index.js';
+import { detectRuleIndex } from '../../../shared/utils/ruleIndex.js';
+import { createDefaultSystemStepServices } from '../../../infra/workflow/system/DefaultSystemStepServices.js';
+import { AbortHandler } from './abortHandler.js';
+import { createIterationLimitHandler, createUserInputHandler } from './iterationLimitHandler.js';
+import { createWorkflowExecutionBootstrap } from './workflowExecutionBootstrap.js';
+import { createWorkflowExecutionContext, createWorkflowCallResolver } from './workflowExecutionContext.js';
+import { bindWorkflowExecutionEvents } from './workflowExecutionEvents.js';
+export async function executeWorkflow(workflowConfig, task, cwd, options) {
+    return executeWorkflowInternal(workflowConfig, task, cwd, options);
+}
+export async function executeWorkflowForRun(workflowConfig, task, cwd, options, runContext) {
+    return executeWorkflowInternal(workflowConfig, task, cwd, options, runContext);
+}
+async function executeWorkflowInternal(workflowConfig, task, cwd, options, runContext) {
+    const bootstrap = createWorkflowExecutionBootstrap(workflowConfig, task, cwd, options);
+    const workflowExecutionContext = createWorkflowExecutionContext(workflowConfig, options.projectCwd);
+    let engine = null;
+    let eventBridge;
+    const getCurrentWorkflowStack = () => {
+        if (!engine || typeof engine.getResumePoint !== 'function') {
+            return undefined;
+        }
+        return engine.getResumePoint()?.stack;
+    };
+    const buildResumePointForStep = (stepName) => {
+        if (!engine || typeof engine.buildResumePointForStepName !== 'function') {
+            return undefined;
+        }
+        return engine.buildResumePointForStepName(stepName);
+    };
+    const getLatestResumePoint = () => {
+        if (!engine || typeof engine.getResumePoint !== 'function') {
+            return undefined;
+        }
+        return engine.getResumePoint();
+    };
+    const iterationLimitHandler = createIterationLimitHandler(bootstrap.out, bootstrap.displayRef, bootstrap.shouldNotifyIterationLimit, (request) => {
+        const resumePoint = getLatestResumePoint()
+            ?? buildResumePointForStep(request.currentStep)
+            ?? eventBridge?.state.lastResumePoint;
+        eventBridge.state.exceededInfo = {
+            currentStep: request.currentStep,
+            newMaxSteps: request.maxSteps + workflowConfig.maxSteps,
+            currentIteration: request.currentIteration,
+            ...(resumePoint ? { resumePoint } : {}),
+        };
+    });
+    const onIterationLimit = runContext?.ignoreIterationLimit === true
+        ? undefined
+        : iterationLimitHandler;
+    const onUserInput = bootstrap.interactiveUserInput
+        ? createUserInputHandler(bootstrap.out, bootstrap.displayRef)
+        : undefined;
+    const runAbortController = new AbortController();
+    const abortHandler = new AbortHandler({
+        externalSignal: options.abortSignal,
+        internalController: runAbortController,
+        getEngine: () => engine,
+    });
+    try {
+        engine = new WorkflowEngine(bootstrap.effectiveWorkflowConfig, cwd, task, {
+            abortSignal: runAbortController.signal,
+            onStream: bootstrap.providerEventLogger.wrapCallback(bootstrap.streamHandler),
+            onUserInput,
+            initialSessions: bootstrap.savedSessions,
+            onSessionUpdate: bootstrap.sessionUpdateHandler,
+            onIterationLimit,
+            onAskUserQuestion: createDenyAskUserQuestionHandler(),
+            ignoreIterationLimit: runContext?.ignoreIterationLimit === true,
+            projectCwd: options.projectCwd,
+            language: options.language,
+            provider: bootstrap.currentProvider,
+            providerSource: bootstrap.currentProviderSource,
+            model: bootstrap.configuredModel,
+            modelSource: bootstrap.configuredModelSource,
+            providerOptions: options.providerOptions,
+            providerOptionsSource: options.providerOptionsSource,
+            providerOptionsOriginResolver: options.providerOptionsOriginResolver,
+            personaProviders: options.personaProviders,
+            providerProfiles: options.providerProfiles,
+            interactive: bootstrap.interactiveUserInput,
+            detectRuleIndex,
+            structuredCaller: bootstrap.structuredCaller,
+            startStep: options.startStep,
+            retryNote: options.retryNote,
+            resumePoint: options.resumePoint,
+            reportDirName: bootstrap.runSlug,
+            taskPrefix: options.taskPrefix,
+            taskColorIndex: options.taskColorIndex,
+            initialIteration: options.initialIterationOverride,
+            currentTask: options.currentTaskIssueNumber !== undefined
+                ? { issueNumber: options.currentTaskIssueNumber }
+                : undefined,
+            systemStepServicesFactory: createDefaultSystemStepServices,
+            workflowCallResolver: createWorkflowCallResolver(workflowExecutionContext),
+        });
+        eventBridge = bindWorkflowExecutionEvents({
+            engine,
+            workflowConfig: bootstrap.effectiveWorkflowConfig,
+            task,
+            projectCwd: options.projectCwd,
+            currentProvider: bootstrap.currentProvider,
+            configuredModel: bootstrap.configuredModel,
+            out: bootstrap.out,
+            prefixWriter: bootstrap.prefixWriter,
+            displayRef: bootstrap.displayRef,
+            handlerRef: bootstrap.handlerRef,
+            providerEventLogger: bootstrap.providerEventLogger,
+            usageEventLogger: bootstrap.usageEventLogger,
+            analyticsEmitter: bootstrap.analyticsEmitter,
+            sessionLogger: bootstrap.sessionLogger,
+            runMetaManager: bootstrap.runMetaManager,
+            ndjsonLogPath: bootstrap.ndjsonLogPath,
+            shouldNotifyWorkflowComplete: bootstrap.shouldNotifyWorkflowComplete,
+            shouldNotifyWorkflowAbort: bootstrap.shouldNotifyWorkflowAbort,
+            writeTraceReportOnce: bootstrap.writeTraceReportOnce,
+            getCurrentWorkflowStack,
+            initialResumePoint: options.resumePoint,
+            sessionLog: bootstrap.sessionLog,
+        });
+        abortHandler.install();
+        const finalState = await engine.run();
+        return {
+            success: finalState.status === 'completed',
+            reason: eventBridge.state.abortReason,
+            lastStep: eventBridge.state.lastStepName,
+            lastMessage: eventBridge.state.lastStepContent,
+            exceeded: eventBridge.state.exceededInfo != null,
+            ...(eventBridge.state.exceededInfo ? { exceededInfo: eventBridge.state.exceededInfo } : {}),
+        };
+    }
+    catch (error) {
+        if (!bootstrap.runMetaManager.isFinalized) {
+            eventBridge?.syncLatestResumePoint();
+            bootstrap.runMetaManager.finalize('aborted');
+        }
+        throw error;
+    }
+    finally {
+        bootstrap.prefixWriter?.flush();
+        abortHandler.cleanup();
+    }
+}
+//# sourceMappingURL=workflowExecution.js.map

package/dist/features/tasks/execute/workflowExecution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowExecution.js","sourceRoot":"","sources":["../../../../src/features/tasks/execute/workflowExecution.ts"],"names":[],"mappings":"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"}

package/dist/features/tasks/execute/workflowExecutionBootstrap.d.ts

@@ -0,0 +1,56 @@
+import { CapabilityAwareStructuredCaller } from '../../../agents/structured-caller.js';
+import type { WorkflowConfig } from '../../../core/models/index.js';
+import { buildRunPaths } from '../../../core/workflow/run/run-paths.js';
+import type { ProviderResolutionSource } from '../../../core/workflow/provider-options-trace.js';
+import { type SessionLog } from '../../../infra/fs/index.js';
+import { isQuietMode } from '../../../shared/context.js';
+import { StreamDisplay } from '../../../shared/ui/index.js';
+import { TaskPrefixWriter } from '../../../shared/ui/TaskPrefixWriter.js';
+import { createProviderEventLogger } from '../../../shared/utils/providerEventLogger.js';
+import { createUsageEventLogger } from '../../../shared/utils/usageEventLogger.js';
+import { AnalyticsEmitter } from './analyticsEmitter.js';
+import { createOutputFns } from './outputFns.js';
+import { RunMetaManager } from './runMeta.js';
+import { SessionLogger } from './sessionLogger.js';
+import { createTraceReportWriter } from './traceReportWriter.js';
+import type { WorkflowExecutionOptions } from './types.js';
+import { detectStepType } from './workflowExecutionUtils.js';
+type DisplayStreamEvent = Parameters<ReturnType<StreamDisplay['createHandler']>>[0];
+export interface WorkflowExecutionBootstrap {
+    interactiveUserInput: boolean;
+    prefixWriter: TaskPrefixWriter | undefined;
+    out: ReturnType<typeof createOutputFns>;
+    displayRef: {
+        current: StreamDisplay | null;
+    };
+    handlerRef: {
+        current: ReturnType<StreamDisplay['createHandler']> | null;
+    };
+    streamHandler: (event: DisplayStreamEvent) => void;
+    isRetry: boolean;
+    isWorktree: boolean;
+    runSlug: string;
+    runPaths: ReturnType<typeof buildRunPaths>;
+    runMetaManager: RunMetaManager;
+    sessionLog: SessionLog;
+    ndjsonLogPath: string;
+    sessionLogger: SessionLogger;
+    shouldNotifyIterationLimit: boolean;
+    shouldNotifyWorkflowComplete: boolean;
+    shouldNotifyWorkflowAbort: boolean;
+    currentProvider: WorkflowExecutionOptions['provider'];
+    currentProviderSource: ProviderResolutionSource;
+    configuredModel: string | undefined;
+    configuredModelSource: ProviderResolutionSource;
+    effectiveWorkflowConfig: WorkflowConfig;
+    providerEventLogger: ReturnType<typeof createProviderEventLogger>;
+    usageEventLogger: ReturnType<typeof createUsageEventLogger>;
+    analyticsEmitter: AnalyticsEmitter;
+    structuredCaller: CapabilityAwareStructuredCaller;
+    savedSessions: Record<string, string>;
+    sessionUpdateHandler: (persona: string, sessionId: string) => void;
+    writeTraceReportOnce: ReturnType<typeof createTraceReportWriter>;
+}
+export declare function createWorkflowExecutionBootstrap(workflowConfig: WorkflowConfig, task: string, cwd: string, options: WorkflowExecutionOptions): WorkflowExecutionBootstrap;
+export { detectStepType, isQuietMode };
+//# sourceMappingURL=workflowExecutionBootstrap.d.ts.map

package/dist/features/tasks/execute/workflowExecutionBootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowExecutionBootstrap.d.ts","sourceRoot":"","sources":["../../../../src/features/tasks/execute/workflowExecutionBootstrap.ts"],"names":[],"mappings":"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"}

package/dist/features/tasks/execute/workflowExecutionBootstrap.js

@@ -0,0 +1,201 @@
+import { join } from 'node:path';
+import { CapabilityAwareStructuredCaller } from '../../../agents/structured-caller.js';
+import { buildRunPaths } from '../../../core/workflow/run/run-paths.js';
+import { resolveRuntimeConfig } from '../../../core/runtime/runtime-environment.js';
+import { loadPersonaSessions, loadWorktreeSessions, resolveWorkflowConfigValues, updatePersonaSession, updateWorktreeSession, } from '../../../infra/config/index.js';
+import { resolveConfigValueWithSource, } from '../../../infra/config/resolveConfigValue.js';
+import { getGlobalConfigDir } from '../../../infra/config/paths.js';
+import { createSessionLog, generateSessionId, initNdjsonLog } from '../../../infra/fs/index.js';
+import { isQuietMode } from '../../../shared/context.js';
+import { TaskPrefixWriter } from '../../../shared/ui/TaskPrefixWriter.js';
+import { createLogger, generateReportDir, getDebugPromptsLogFile, isValidReportDirName, preventSleep } from '../../../shared/utils/index.js';
+import { createProviderEventLogger, isProviderEventsEnabled } from '../../../shared/utils/providerEventLogger.js';
+import { sanitizeTerminalText } from '../../../shared/utils/text.js';
+import { createUsageEventLogger, isUsageEventsEnabled } from '../../../shared/utils/usageEventLogger.js';
+import { initAnalyticsWriter } from '../../analytics/index.js';
+import { AnalyticsEmitter } from './analyticsEmitter.js';
+import { createOutputFns, createPrefixedStreamHandler } from './outputFns.js';
+import { RunMetaManager } from './runMeta.js';
+import { SessionLogger } from './sessionLogger.js';
+import { createTraceReportWriter } from './traceReportWriter.js';
+import { sanitizeTextForStorage } from './traceReportRedaction.js';
+import { assertTaskPrefixPair, detectStepType } from './workflowExecutionUtils.js';
+const log = createLogger('workflow');
+export function createWorkflowExecutionBootstrap(workflowConfig, task, cwd, options) {
+    const { headerPrefix = 'Running Workflow:', interactiveUserInput = false } = options;
+    const projectCwd = options.projectCwd;
+    const safeWorkflowName = sanitizeTerminalText(workflowConfig.name);
+    assertTaskPrefixPair(options.taskPrefix, options.taskColorIndex);
+    const prefixWriter = options.taskPrefix != null
+        ? new TaskPrefixWriter({
+            taskName: options.taskPrefix,
+            colorIndex: options.taskColorIndex,
+            displayLabel: options.taskDisplayLabel,
+        })
+        : undefined;
+    const out = createOutputFns(prefixWriter);
+    out.header(`${headerPrefix} ${safeWorkflowName}`);
+    const displayRef = { current: null };
+    const handlerRef = { current: null };
+    const streamHandler = prefixWriter
+        ? createPrefixedStreamHandler(prefixWriter)
+        : (event) => {
+            if (!displayRef.current || event.type === 'result') {
+                return;
+            }
+            if (!handlerRef.current) {
+                handlerRef.current = displayRef.current.createHandler();
+            }
+            handlerRef.current(event);
+        };
+    const isRetry = Boolean(options.startStep || options.retryNote || options.resumePoint);
+    const isWorktree = cwd !== projectCwd;
+    log.debug('Session mode', { isRetry, isWorktree });
+    const runSlug = options.reportDirName ?? generateReportDir(task);
+    if (!isValidReportDirName(runSlug)) {
+        throw new Error(`Invalid reportDirName: ${runSlug}`);
+    }
+    const runPaths = buildRunPaths(cwd, runSlug);
+    const runMetaManager = new RunMetaManager(runPaths, task, workflowConfig.name);
+    const sessionLog = createSessionLog(task, projectCwd, workflowConfig.name);
+    const globalConfig = resolveWorkflowConfigValues(projectCwd, [
+        'notificationSound',
+        'notificationSoundEvents',
+        'provider',
+        'runtime',
+        'preventSleep',
+        'model',
+        'logging',
+        'analytics',
+    ]);
+    const traceReportMode = globalConfig.logging?.trace === true ? 'full' : 'redacted';
+    const allowSensitiveData = traceReportMode === 'full';
+    const workflowSessionId = generateSessionId();
+    const ndjsonLogPath = initNdjsonLog(workflowSessionId, sanitizeTextForStorage(task, allowSensitiveData), workflowConfig.name, { logsDir: runPaths.logsAbs });
+    const sessionLogger = new SessionLogger(ndjsonLogPath, allowSensitiveData);
+    if (options.interactiveMetadata) {
+        sessionLogger.writeInteractiveMetadata(options.interactiveMetadata);
+    }
+    const shouldNotify = globalConfig.notificationSound !== false;
+    const shouldNotifyIterationLimit = shouldNotify && globalConfig.notificationSoundEvents?.iterationLimit !== false;
+    const shouldNotifyWorkflowComplete = shouldNotify && globalConfig.notificationSoundEvents?.workflowComplete !== false;
+    const shouldNotifyWorkflowAbort = shouldNotify && globalConfig.notificationSoundEvents?.workflowAbort !== false;
+    const currentProvider = options.provider ?? globalConfig.provider;
+    if (!currentProvider) {
+        throw new Error('No provider configured. Set "provider" in ~/.takt/config.yaml');
+    }
+    const currentProviderSource = resolveProviderFieldSource(projectCwd, 'provider', options.provider, options.providerSource);
+    const configuredModel = options.model ?? globalConfig.model;
+    const configuredModelSource = resolveProviderFieldSource(projectCwd, 'model', options.model, options.modelSource);
+    const effectiveWorkflowConfig = {
+        ...workflowConfig,
+        runtime: resolveRuntimeConfig(globalConfig.runtime, workflowConfig.runtime),
+        ...(options.maxStepsOverride !== undefined ? { maxSteps: options.maxStepsOverride } : {}),
+    };
+    const providerEventLogger = createProviderEventLogger({
+        logsDir: runPaths.logsAbs,
+        sessionId: workflowSessionId,
+        runId: runSlug,
+        provider: currentProvider,
+        step: options.startStep ?? workflowConfig.initialStep,
+        enabled: isProviderEventsEnabled(globalConfig),
+    });
+    const usageEventLogger = createUsageEventLogger({
+        logsDir: runPaths.logsAbs,
+        sessionId: workflowSessionId,
+        runId: runSlug,
+        provider: currentProvider,
+        providerModel: configuredModel ?? '(default)',
+        step: options.startStep ?? workflowConfig.initialStep,
+        stepType: 'normal',
+        enabled: isUsageEventsEnabled(globalConfig),
+    });
+    initAnalyticsWriter(globalConfig.analytics?.enabled === true, globalConfig.analytics?.eventsPath ?? join(getGlobalConfigDir(), 'analytics', 'events'));
+    if (globalConfig.preventSleep) {
+        preventSleep();
+    }
+    const analyticsEmitter = new AnalyticsEmitter(runSlug, currentProvider, configuredModel ?? '(default)');
+    const structuredCaller = new CapabilityAwareStructuredCaller();
+    const savedSessions = isRetry
+        ? (isWorktree
+            ? loadWorktreeSessions(projectCwd, cwd, currentProvider)
+            : loadPersonaSessions(projectCwd, currentProvider))
+        : {};
+    const sessionUpdateHandler = isWorktree
+        ? (personaName, personaSessionId) => updateWorktreeSession(projectCwd, cwd, personaName, personaSessionId, currentProvider)
+        : (persona, personaSessionId) => updatePersonaSession(projectCwd, persona, personaSessionId, currentProvider);
+    const writeTraceReportOnce = createTraceReportWriter({
+        sessionLogger,
+        ndjsonLogPath,
+        tracePath: join(runPaths.runRootAbs, 'trace.md'),
+        workflowName: workflowConfig.name,
+        task,
+        runSlug,
+        promptLogPath: getDebugPromptsLogFile() ?? undefined,
+        mode: traceReportMode,
+        logger: log,
+    });
+    return {
+        interactiveUserInput,
+        prefixWriter,
+        out,
+        displayRef,
+        handlerRef,
+        streamHandler,
+        isRetry,
+        isWorktree,
+        runSlug,
+        runPaths,
+        runMetaManager,
+        sessionLog,
+        ndjsonLogPath,
+        sessionLogger,
+        shouldNotifyIterationLimit,
+        shouldNotifyWorkflowComplete,
+        shouldNotifyWorkflowAbort,
+        currentProvider,
+        currentProviderSource,
+        configuredModel,
+        configuredModelSource,
+        effectiveWorkflowConfig,
+        providerEventLogger,
+        usageEventLogger,
+        analyticsEmitter,
+        structuredCaller,
+        savedSessions,
+        sessionUpdateHandler,
+        writeTraceReportOnce,
+    };
+}
+function mapConfigSourceToResolutionSource(source) {
+    switch (source) {
+        case 'project':
+            return 'project';
+        case 'global':
+            return 'global';
+        case 'default':
+            return 'default';
+        default:
+            // 'env' / 'workflow' do not occur for provider/model in bootstrap context.
+            return 'default';
+    }
+}
+function resolveProviderFieldSource(projectCwd, key, cliValue, cliSource) {
+    if (cliValue !== undefined) {
+        return cliSource ?? 'cli';
+    }
+    try {
+        const resolved = resolveConfigValueWithSource(projectCwd, key);
+        if (resolved.value !== undefined) {
+            return mapConfigSourceToResolutionSource(resolved.source);
+        }
+    }
+    catch {
+        // Config resolution may fail in test contexts where paths are synthetic;
+        // fall back to 'global' as a reasonable default since the value itself
+        // was loaded successfully via resolveWorkflowConfigValues.
+    }
+    return 'global';
+}
+export { detectStepType, isQuietMode };
+//# sourceMappingURL=workflowExecutionBootstrap.js.map