agent-workflow/src/index.ts

/**
 * agent-workflow — Codex-hosted autonomous implementation loop.
 *
 * Public API exports for programmatic use.
 */

export {
  startWorkflow,
  reviewWorkflow,
  decideWorkflow,
  statusWorkflow,
  abortWorkflow,
  logsWorkflow,
  retryReviewWorkflow,
  retryExecuteWorkflow,
  extendWorkflow,
  WorkflowEngineError,
  emitWorkflowMeta,
  resolveVcsSelection,
} from "./workflow-engine.js";

export type {
  StartWorkflowOpts,
  ReviewWorkflowOpts,
  DecideWorkflowOpts,
  StatusWorkflowOpts,
  AbortWorkflowOpts,
  LogsWorkflowOpts,
  RetryReviewWorkflowOpts,
  RetryExecuteWorkflowOpts,
  ExtendWorkflowOpts,
} from "./workflow-engine.js";

export {
  WorkflowConfigError,
  loadProjectWorkflowConfig,
  resolveWorkflowConfig,
  validateWorkflowPlan,
  validateHostDecision,
} from "./workflow-config.js";

export type {
  WorkflowCliOverrides,
} from "./workflow-config.js";

export {
  workflowsRoot,
  repoHash,
  runDir,
  lockFilePath,
  stateFilePath,
  eventsFilePath,
  cycleDiffFile,
  cycleExecLogFile,
  cycleHostReviewFile,
  cycleDecisionFile,
  generateRunId,
  writeState,
  readState,
  appendEvent,
  WorkflowLockError,
  acquireLock,
  releaseLock,
  readLock,
  GitError,
  gitRepoRoot,
  gitHead,
  gitIsClean,
  gitDiffFromHead,
  checkFilesInScope,
  nowIso,
  initWorkflowState,
  findRunDir,
  writeProgressSidecar,
  readProgressSidecar,
  progressSidecarPath,
  attemptLogPath,
  nextAttemptIndex,
} from "./workflow-state.js";

export {
  checkConvergence,
  decisionSignatures,
} from "./workflow-convergence.js";

export type {
  FindingSignature,
  ConvergenceCheckResult,
} from "./workflow-convergence.js";

export {
  createExecutorAdapter,
  probeExecutor,
} from "./workflow-executor.js";

export type {
  ExecutorAdapter,
  ExecutorResult,
  ExecutorStartOpts,
  ExecutorResumeOpts,
  ProgressSidecar,
} from "./workflow-types.js";

export {
  parseWorkflowArgs,
  workflowUsage,
} from "./workflow-args.js";

export type {
  WorkflowSubcommand,
  WorkflowArgs,
  WorkflowStartArgs,
  WorkflowReviewArgs,
  WorkflowRetryReviewArgs,
  WorkflowRetryExecuteArgs,
  WorkflowDecideArgs,
  WorkflowStatusArgs,
  WorkflowAbortArgs,
  WorkflowLogsArgs,
  WorkflowExtendArgs,
} from "./workflow-args.js";

export type {
  WorkflowPlanV1,
  WorkflowState,
  WorkflowStatus,
  WorkflowActiveStatus,
  WorkflowTerminalStatus,
  WorkflowStatusOutput,
  HostDecisionV1,
  HostDecisionOutcome,
  FindingDecision,
  HostReviewBundleV1,
  WorkflowProjectConfig,
  ResolvedWorkflowConfig,
  ExecutorConfig,
  ExecutorKind,
  ExecutorSessionHandle,
  ReasonixSessionHandle,
  ClaudeSessionHandle,
  AgySessionHandle,
  CycleRecord,
  ScopeViolation,
  WorkflowEvent,
  WorkflowEventKind,
  VcsKind,
  VcsBaseline,
  VcsBaselineGit,
  VcsBaselineSvn,
  ExtensionRecord,
} from "./workflow-types.js";

export {
  EXECUTOR_KINDS,
  WORKFLOW_STATUSES,
  WORKFLOW_ACTIVE_STATUSES,
  WORKFLOW_TERMINAL_STATUSES,
  HOST_DECISION_OUTCOMES,
  VCS_KINDS,
} from "./workflow-types.js";

export {
  spawnBufferedChild,
  spawnStreamingChild,
  DEFAULT_STREAM_CAPTURE_LIMIT,
  DEFAULT_ABORT_KILL_GRACE_MS,
} from "./child-process.js";

export type {
  ChildRunResult,
  StreamProgress,
} from "./child-process.js";

export {
  VcsError,
  GitProvider,
  SvnProvider,
  detectVcs,
  createVcsProvider,
  extractBaselineHead,
  findVcsCandidates,
} from "./vcs-provider.js";

export type {
  VcsProvider,
} from "./vcs-provider.js";