Function createRunAction

packages/cli/src/commands/run.ts:490–551

(program: Command)

}

export function createRunAction(program: Command): (path: string | undefined, options: RunOptions) => Promise<void> {
  return async (path, options) => {
    try {
      if (!path && !options.prompt) {
        program.error(getChalk().red('Missing required argument: path (or use --prompt)'), {
          exitCode: ExitCode.InvalidUsage,
        })
      }

      debug(`Running file: ${path ?? '(prompt-only)'}`)
      const safeOptions = { ...options, token: options.token ? '[redacted]' : undefined }
      debug(`Options: ${JSON.stringify(safeOptions)}`)

      // Handle --list-inputs
      if (options.listInputs) {
        if (!path) {
          program.error(getChalk().red('--list-inputs requires a file path'), {
            exitCode: ExitCode.InvalidUsage,
          })
        }
        await listInputs(path, options)
        return
      }

      // Handle --dry-run
      if (options.dryRun) {
        if (!path) {
          program.error(getChalk().red('--dry-run requires a file path'), {
            exitCode: ExitCode.InvalidUsage,
          })
        }
        await dryRunDeepnoteProject(path, options)
        return
      }

      await runDeepnoteProject(path, options)
    } catch (error) {
      const message = error instanceof Error ? error.message : String(error)
      // Use InvalidUsage for file/input/integration/init-resolver/API-auth errors — all user errors.
      const isAuthApiError = error instanceof ApiError && (error.statusCode === 401 || error.statusCode === 403)
      const exitCode =
        error instanceof FileResolutionError ||
        error instanceof MissingInputError ||
        error instanceof MissingIntegrationError ||
        error instanceof InitNotebookResolutionError ||
        isAuthApiError
          ? ExitCode.InvalidUsage
          : ExitCode.Error
      if (options.output === 'json') {
        outputJson({ success: false, error: message })
        process.exitCode = exitCode
        return
      }
      if (options.output === 'toon') {
        outputToon({ success: false, error: message })
        process.exitCode = exitCode
        return
      }